pdf-mcp
MCP PDF для больших документов: агент ищет по смыслу и по ключевым словам в одном файле или папке и читает только нужные страницы, таблицы и сканы
- 155 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер читает файлы по путям агента и может скачать PDF по URL
- Текст PDF приходит в контекст как недоверенные данные, возможен скрытый текст с инструкциями
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/pdf-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер читает файлы по путям агента и может скачать PDF по URL
- Текст PDF приходит в контекст как недоверенные данные, возможен скрытый текст с инструкциями
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
pdf-mcp — MCP PDF сервер для Claude Code и других агентов, который решает проблему больших файлов: вместо загрузки всего документа в контекст агент сначала запрашивает карточку pdf_info, потом ищет через pdf_search и читает только найденные страницы через pdf_read_pages. Поиск гибридный: ключевые слова по алгоритму BM25 плюс поиск по смыслу. Выдача возвращает абзацы-фрагменты с координатами источника и разделом, к которому относится совпадение. Для папки с документами есть pdf_corpus_warm, pdf_corpus_overview и pdf_corpus_search: сервер подготавливает кэш, показывает карточки документов и ищет по всем сразу. Всего в сервере 13 инструментов. Среди них pdf_render_pages выводит страницы картинками для моделей с видением, pdf_extract_chart достает точные пары (x, y) из векторных диаграмм, а OCR через Tesseract работает постранично и параллельно. Правильный порядок чтения сохраняется для многоколоночных и японских вертикальных макетов. Результаты кэшируются в SQLite и переживают перезапуск.
Для кого. Для тех, кто разбирает с агентом длинные PDF: отчеты, регламенты, научные статьи, подборки документов в одной папке.
Подходит, если
- В отчете на 200 страниц нужно найти раздел про угрозы бизнесу и прочитать только его
- В папке десяток документов, и нужен поиск сразу по всем с указанием файла и страницы
- Нужны таблицы из PDF в виде строк и данные диаграммы в виде точных значений
- PDF отсканирован, и текст приходится брать через OCR
- Файл многоколоночный или на японском с вертикальной версткой, а обычное чтение путает порядок
Не подходит, если
- Нужна конвертация PDF в Word, Excel или презентацию и правка страниц: сервер читает документы и ничего не переделывает
- Нужны EPUB и разговор с книгой по главам: формат EPUB сервер не поддерживает
- Нужен открытый сетевой сервер без авторизации: HTTP-режим не запустится без токена или списка разрешенных путей
- Достаточно прочитать один короткий PDF: хватит встроенного чтения файла в клиенте
Пример запроса к агенту
Найди в годовом отчете report.pdf раздел про угрозы бизнесу, прочитай только эти страницы и сделай краткую выжимку со ссылками на страницы.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
PDF_MCP_AUTH_TOKENсекрет- Токен для HTTP-режима pdf-mcp-http; без него и без списка разрешенных путей HTTP-сервер не запускается
Ограничения
Нужен Python 3.10 или новее. OCR для сканов требует установленного Tesseract; в расширении для Claude Desktop английский Tesseract размером около 14 МБ скачивается при первой отсканированной странице. Первый запуск расширения скачивает компоненты примерно на 250 МБ и занимает несколько минут. Расширению нужны Windows 10 или новее, либо macOS 13 или новее.
Для неанглийских документов настройте языковую поддержку по отдельной странице документации. Ускорение на CUDA доступно на видеокартах NVIDIA. HTTP-режим из соображений безопасности не запустится без токена PDF_MCP_AUTH_TOKEN или списка разрешенных путей.
Текст из PDF приходит как недоверенный: pdf_info с параметром content_trust=True сообщает о скрытом тексте, невидимом человеку.
Как отключить. Для Claude Code выполните claude mcp remove pdf-mcp и при желании uv tool `uninstall` pdf-mcp. Расширение для Claude Desktop удаляется на странице Settings, Extensions. Кэш SQLite очищает инструмент pdf_cache_clear.
Частые вопросы
Как поставить MCP PDF (pdf-mcp) в Claude Code?
Выполните uv tool install pdf-mcp, затем claude mcp add pdf-mcp -- pdf-mcp. Подойдет и pipx install pdf-mcp. Для Claude Desktop есть готовый файл pdf-mcp.mcpb в релизах: его перетаскивают в Settings, Extensions.
Как читать большие PDF в Claude Code без переполнения контекста?
Агент сначала вызывает pdf_info, чтобы узнать число страниц и оглавление, потом pdf_search для поиска и pdf_read_pages только по нужным страницам. Автор показывает на демо, что в контекст попадает малая часть корпуса.
Умеет ли pdf-mcp читать сканы?
Да, через Tesseract OCR, постранично и параллельно. Для сервера из PyPI Tesseract нужно поставить отдельно: brew install tesseract на macOS, apt install tesseract-ocr на Ubuntu, winget на Windows. В расширении для Claude Desktop английский Tesseract скачивается сам.
Чем pdf-mcp отличается от Citra и ComPDF MCP?
pdf-mcp делает упор на поиск по папке PDF и экономию контекста, работает локально и ничего не конвертирует. ComPDF MCP, наоборот, конвертирует и правит PDF через облачный API ComPDF. Citra читает PDF со структурным текстом и цитатами.
Можно ли запустить pdf-mcp как сетевой сервер?
Да, командой pdf-mcp-http. Он нужен клиентам, которые не умеют запускать процесс, например коннектору MCP в API Anthropic. Без токена PDF_MCP_AUTH_TOKEN и списка разрешенных путей процесс не стартует. Есть образы Docker в GHCR для amd64 и arm64.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP PDF от ComPDF: агент конвертирует PDF и изображения в Word, Excel, Markdown и JSON, объединяет, режет, защищает и сравнивает файлы через облачный API
MCP-сервер для чтения PDF: структурный текст, таблицы, OCR, визуальные вырезки и цитаты с указанием страницы
MCP PDF ebook: агент находит книги в папке и читает EPUB и PDF по главам и страницам, получая оглавление, метаданные и текст в Markdown
MCP-сервер на базе Docling: переводит PDF в структурированный документ, собирает новые документы и загружает их в RAG
MCP-сервер, который превращает PDF, DOCX, XLSX, PPTX, изображения, аудио, веб-страницы и расшифровки YouTube в Markdown
Перевод научных PDF с сохранением формул, таблиц и верстки: CLI, Docker и MCP-сервер для агентов
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| pdf-mcp (эта запись) | нет | не нужна | 155 | |
| Citra | да | не нужна | 1 050 | MCP-сервер для чтения PDF со структурным текстом, таблицами и цитатами с номером страницы |
| ComPDF MCP | да | API-ключ | 98 | конвертирует и правит PDF через облачный API ComPDF, а не ищет по документам |
| Ebook-MCP | нет | не нужна | 394 | читает EPUB и PDF по главам для разговора с книгой |
Из блога
Коротко о README
В документации есть сравнительная таблица «без pdf-mcp и с ним», установка для Claude Desktop через mcpb и для Claude Code через uv или pipx, список из 13 инструментов с типовым порядком вызова, примеры запросов, пример работы с годовым отчетом, раздел про HTTP-транспорт с Docker и ссылки на справочник параметров, выбор моделей эмбеддингов и модель угроз. В браузере доступна демонстрация, где PDF обрабатываются на стороне клиента.