pdf-mcp — MCP-сервер для Claude Code: поиск по PDF и папкам
Даёт агенту доступ к одному PDF или целой папке: гибридный поиск, чтение нужных страниц, таблицы и OCR сканов.
claude mcp add --env PDF_MCP_CACHE_DIR=<PDF_MCP_CACHE_DIR> --env PDF_MCP_CACHE_TTL=<PDF_MCP_CACHE_TTL> --transport stdio pdf-mcp -- uvx pdf-mcpЧто делает pdf-mcp
pdf-mcp — это MCP-сервер, который превращает PDF в источник для агента. Агент сам решает, когда искать, а сервер делает поиск и возвращает выдержки. Работает по одному файлу или по папке целиком: сначала прогрев корпуса в кэш, потом триаж документов и поиск сразу по всем.
Внутри 13 отдельных инструментов вместо одного большого. pdf_info показывает число страниц, метаданные, оглавление и находит сканы. pdf_search ищет по ключевым словам и по смыслу, отдаёт абзац или окно контекста с координатами источника. pdf_read_pages читает нужные страницы, при необходимости с OCR, таблицами и картинками. Для папки — pdf_corpus_overview и pdf_corpus_search. Есть рендер страниц в PNG для vision-моделей и извлечение данных графиков в виде таблиц (x, y). Результаты кэшируются в SQLite и переживают перезапуск.
Нужен Python 3.10 или новее, а команду pdf-mcp ставят через uv или pipx. Для OCR сканированных страниц отдельно нужен Tesseract: без него распознавание не заработает. Неанглийские документы требуют настройки языка, об этом сказано в документации. Ускорение на CUDA доступно только на картах NVIDIA.
Какие задачи решает
- найти нужный абзац в PDF на сотни страниц, не загружая его целиком
- прочитать только те страницы, где есть ответ
- разобрать таблицу или данные графика из документа
- распознать текст в сканах через OCR
- искать сразу по папке PDF с указанием документа и страницы
Примеры запросов агенту
- Посмотри
report.pdfчерез pdf-mcp и скажи, о чём он - Найди в этой папке PDF всё про условия оплаты и покажи страницы
- Вытащи таблицу из
invoice.pdfи приведи её строками
Как установить pdf-mcp
Командой платформы
claude mcp add --env PDF_MCP_CACHE_DIR=<PDF_MCP_CACHE_DIR> --env PDF_MCP_CACHE_TTL=<PDF_MCP_CACHE_TTL> --transport stdio pdf-mcp -- uvx pdf-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from pdf-mcp <команда>
Командой платформы
codex mcp add pdf-mcp --env PDF_MCP_CACHE_DIR=<PDF_MCP_CACHE_DIR> --env PDF_MCP_CACHE_TTL=<PDF_MCP_CACHE_TTL> -- uvx pdf-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from pdf-mcp <команда>
Файл настроек
{
"mcpServers": {
"pdf-mcp": {
"command": "uvx",
"args": [
"pdf-mcp"
],
"env": {
"PDF_MCP_CACHE_DIR": "<PDF_MCP_CACHE_DIR>",
"PDF_MCP_CACHE_TTL": "<PDF_MCP_CACHE_TTL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from pdf-mcp <команда>
Файл настроек
{
"servers": {
"pdf-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"pdf-mcp"
],
"env": {
"PDF_MCP_CACHE_DIR": "<PDF_MCP_CACHE_DIR>",
"PDF_MCP_CACHE_TTL": "<PDF_MCP_CACHE_TTL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from pdf-mcp <команда>
Командой платформы
gemini mcp add -e PDF_MCP_CACHE_DIR=<PDF_MCP_CACHE_DIR> -e PDF_MCP_CACHE_TTL=<PDF_MCP_CACHE_TTL> pdf-mcp uvx pdf-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from pdf-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о pdf-mcp
Как установить pdf-mcp в Claude Code?
Сначала поставьте команду: uv tool install pdf-mcp или pipx install pdf-mcp. Затем добавьте сервер: claude mcp add pdf-mcp -- uvx pdf-mcp.
Что делает pdf-mcp?
Это MCP-сервер для поиска и чтения PDF. Агент ищет по смыслу или по ключевым словам, читает только нужные страницы и достаёт таблицы, картинки и текст сканов.
Что нужно для работы pdf-mcp?
Python 3.10 или новее. Для OCR сканированных страниц нужен установленный Tesseract, иначе распознавание не запустится.
