pdfmux — MCP-сервер для Claude Code: извлекает PDF и устанавливает
Извлекает текст из PDF в Markdown и проверяет результат на пропущенные страницы. Пригодится для подготовки документов к RAG и проверки работы другого экстрактора.
claude mcp add pdfmux -e GEMINI_API_KEY=<GEMINI_API_KEY> -- uvx pdfmuxЧто делает pdfmux
pdfmux разбирает PDF по страницам, проверяет извлечённый текст и отмечает страницы, которые экстрактор пропустил. Результат можно использовать для RAG; сервер также проверяет вывод других инструментов и сопоставляет его с исходным документом. Это полезно, когда важно заметить тихую потерю текста, а не принять пустую страницу за успешный разбор.
Для подключения в Claude Code используется uvx pdfmux и переменная GEMINI_API_KEY. Ключ нужно подготовить заранее. Сам пакет требует Python 3.11 или новее; для обработки сканов в установке пакета нужна опция ocr, иначе такие страницы могут вернуть пустой текст. В качестве MCP-сервера pdfmux рассчитан также на Codex, Cursor, GitHub Copilot, Windsurf, Cline и Zed.
Какие задачи решает
- извлечь текст из PDF в Markdown
- найти страницы, которые экстрактор пропустил
- проверить вывод другого инструмента по исходному PDF
- подготовить извлечённый текст для RAG
Примеры запросов агенту
- Извлеки текст из
report.pdfи проверь, не пропущены ли страницы. - Сверь результат разбора
invoice.pdfс исходным PDF и отметь пустые страницы. - Проверь вывод моего экстрактора по
report.pdfна потерянные страницы.
Как установить pdfmux
Командой платформы
claude mcp add pdfmux -e GEMINI_API_KEY=<GEMINI_API_KEY> -- uvx pdfmuxВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from pdfmux <команда>
Командой платформы
codex mcp add pdfmux --env GEMINI_API_KEY=<GEMINI_API_KEY> -- uvx pdfmuxВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from pdfmux <команда>
Файл настроек
{
"mcpServers": {
"pdfmux": {
"command": "uvx",
"args": [
"pdfmux"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from pdfmux <команда>
Файл настроек
{
"servers": {
"pdfmux": {
"type": "stdio",
"command": "uvx",
"args": [
"pdfmux"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from pdfmux <команда>
Командой платформы
gemini mcp add -e GEMINI_API_KEY=<GEMINI_API_KEY> pdfmux uvx pdfmuxВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from pdfmux <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о pdfmux
Как установить pdfmux в Claude Code?
Добавьте сервер командой claude mcp add pdfmux -e GEMINI_API_KEY=<GEMINI_API_KEY> -- uvx pdfmux. Подставьте свой ключ Gemini вместо плейсхолдера.
Что делает pdfmux?
Извлекает содержимое PDF и проверяет, не потерялись ли страницы. Также может проверять результаты других экстракторов по исходному документу.
Что нужно для обработки сканов?
Для сканов нужна OCR-опция пакета: без OCR такие страницы могут вернуть пустой текст. Пакету требуется Python 3.11 или новее.
