ComPDF MCP
MCP PDF от ComPDF: агент конвертирует PDF и изображения в Word, Excel, Markdown и JSON, объединяет, режет, защищает и сравнивает файлы через облачный API
- 98 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Файлы целиком уходят во внешний облачный API, а в договорах и счетах бывают персональные и финансовые данные
- Инструменты шифруют, снимают пароль и водяные знаки, объединяют и режут файлы, результат пишется на диск
Установка
- Работает в
Ручная установка
pip install -e .Выполняется в корне репозитория внутри виртуального окружения; затем cp .env.example .env и запуск compdf-streaming-mcp.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Файлы целиком уходят во внешний облачный API, а в договорах и счетах бывают персональные и финансовые данные
- Инструменты шифруют, снимают пароль и водяные знаки, объединяют и режут файлы, результат пишется на диск
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
ComPDF MCP — MCP PDF сервис от команды ComPDF. Он запускается у вас как HTTP-сервис на Python (FastMCP и Starlette) и отправляет файлы в облачный API ComPDF. Идея авторов: сначала превратить объемный шумный PDF или скан в легкий структурный результат, и только потом отдать его модели, так тратится меньше токенов. Инструменты делятся на три группы. Конвертация: PDF в Word, Excel, PowerPoint, HTML, RTF, изображение, CSV, TXT, JSON, Markdown, PDF с поиском и OFD, обратные направления из Word, Excel, TXT, CSV, HTML и картинок, а также изображения в Word, Excel, JSON и другие форматы. Работа с PDF: объединение, разделение, поворот, удаление, вставка и извлечение страниц, водяные знаки, сжатие, шифрование, снятие пароля у разрешенных файлов и сравнение двух файлов. Интеллектуальный разбор: document_parse и document_extract. Все 44 синхронных инструмента доступны по одному адресу /mcp, а три модуля можно подключить отдельно. Для долгих задач есть асинхронный режим с проверкой статуса.
Для кого. Для тех, кто обрабатывает пачки отчетов, договоров, счетов и сканов и хочет поручить агенту конвертацию и правку PDF до анализа.
Подходит, если
- Нужно превратить отчет или руководство в Markdown или Word и только потом просить модель сделать выжимку
- Из счетов и сканированных таблиц требуется достать таблицы и вывести их в CSV или JSON
- Надо слить несколько PDF, поставить водяной знак и вернуть готовый файл
- Нужно сравнить две версии договора и увидеть отличия
- Скан надо превратить в PDF с выделяемым текстом для поиска и архива
Не подходит, если
- Документы нельзя отправлять третьей стороне: файлы уходят в облачный API ComPDF, локальной обработки в сервисе нет
- Нужен поиск по смыслу в папке PDF с экономией контекста: для чтения и поиска лучше подойдут серверы вроде pdf-mcp
- Нужна установка одной командой из менеджера пакетов: сервис разворачивается из репозитория вместе с файлом .env
- Файлы крупнее 100 МБ в Base64: это предел для одного файла
Пример запроса к агенту
Преобразуй report.pdf в Markdown и выведи все таблицы отдельно в CSV, затем кратко перескажи отчет.MCP
- Транспорт
- http
- Авторизация
- API-ключ
Переменные окружения
COMPDF_API_KEYобязательная, секрет- Личный API-ключ ComPDF; клиент передает его заголовком X-ComPDF-API-Key, сервер его не хранит
Ограничения
Для работы нужен личный API-ключ ComPDF, он бесплатный для проб и проверки сценариев, для большего объема нужна связь с отделом продаж. Сервер не хранит ключ: клиент передает его заголовком X-ComPDF-API-Key с каждым запросом. Для аккаунтов из материкового Китая в настройках указан другой адрес API.
Файл передается в Base64, предел для одного файла после декодирования 100 МБ. Ссылки на готовые файлы действуют 24 часа. Нужен Python 3.10 или новее, сервис по умолчанию слушает порт 8000. В рабочей среде документация предлагает HTTPS-прокси и токены доступа поверх ключа ComPDF.
Под вопросом остается, насколько этот сервис доступен из России: при подготовке карточки это не проверялось.
Как отключить. Остановите процесс compdf-streaming-mcp или выполните docker compose down и уберите блок compdf из конфигурации клиента. Ключ ComPDF отзывается в личном кабинете ComPDF Portal.
Частые вопросы
Как поставить MCP PDF от ComPDF в Claude Code?
Установите сервис командой pip install -e . в виртуальном окружении, скопируйте .env.example в .env и запустите compdf-streaming-mcp. Затем добавьте в файл ~/.claude.json сервер compdf с типом http, адресом http://127.0.0.1:8000/mcp и заголовком X-ComPDF-API-Key из переменной COMPDF_API_KEY.
Нужен ли ключ для ComPDF MCP и сколько он стоит?
Нужен личный ключ, его выдают бесплатно в ComPDF Portal после регистрации. Бесплатного доступа достаточно для проб и проверки сценариев. Для больших объемов и корпоративного размещения авторы предлагают обратиться в отдел продаж.
Куда уходят мои PDF при работе через ComPDF MCP?
Сервис отправляет файлы в облачный API ComPDF. Локальной обработки в нем нет, и ссылки на результат действуют 24 часа. Для конфиденциальных документов используйте такой маршрут только если политика безопасности позволяет.
Чем ComPDF MCP отличается от pdf-mcp и MarkItDown?
ComPDF MCP конвертирует PDF и изображения в десятки форматов, правит страницы и защищает файлы через облачный API. pdf-mcp ищет и читает PDF локально, MarkItDown превращает файлы в Markdown.
Можно ли подключить только часть инструментов ComPDF MCP?
Да. Кроме общего адреса /mcp с 44 инструментами есть модули: /mcp/conversion/mcp для конвертации, /mcp/ai/mcp для интеллектуального разбора и /mcp/pdf/mcp для редактирования и сравнения.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер, который превращает PDF, DOCX, XLSX, PPTX, изображения, аудио, веб-страницы и расшифровки YouTube в Markdown
MCP PDF для больших документов: агент ищет по смыслу и по ключевым словам в одном файле или папке и читает только нужные страницы, таблицы и сканы
Утилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели
Перевод научных PDF с сохранением формул, таблиц и верстки: CLI, Docker и MCP-сервер для агентов
MCP-сервер на базе Docling: переводит PDF в структурированный документ, собирает новые документы и загружает их в RAG
MCP-сервер для чтения PDF: структурный текст, таблицы, OCR, визуальные вырезки и цитаты с указанием страницы
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ComPDF MCP (эта запись) | да | API-ключ | 98 | |
| pdf-mcp | нет | не нужна | 155 | читает и ищет в PDF локально, ничего не конвертируя |
| MarkItDown | да | не нужна | 191 675 | превращает файлы в Markdown утилитой на вашем компьютере |
| Citra | да | не нужна | 1 050 | MCP-сервер для чтения PDF с цитатами и номерами страниц |
Коротко о README
В документации объяснена идея «сначала обработать документ, потом отдать модели», таблицы возможностей по трем группам, архитектура с модульными адресами, формат входных файлов в Base64, установка на Windows, Linux и macOS, настройка .env, готовые конфигурации для Codex, Claude Code, GitHub Copilot в VS Code и Cursor, асинхронный режим и загрузка по подписанным ссылкам, развертывание через Docker Compose и примеры запросов.