PDFMathTranslate
Перевод научных PDF с сохранением формул, таблиц и верстки: CLI, Docker и MCP-сервер для агентов
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Отправляет содержимое документа во внешний сервис перевода
- Часть сервисов перевода требует платного API-ключа
Установка
Ручная установка
pip install uv
uv tool install --python 3.12 pdf2zhУстановка через uv, затем перевод командой pdf2zh document.pdf
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Инструмент переводит научные PDF-документы, сохраняя формулы, диаграммы, оглавление и аннотации на месте. Работает как командная строка (pdf2zh document.pdf), веб-интерфейс, Docker-образ и MCP-сервер: флаг --mcp запускает его в режиме stdio, а --mcp --sse в режиме SSE. Поддерживает несколько сервисов перевода на выбор через флаг -s. В коде MCP-инструмента translate_pdf сейчас жестко задан сервис Google, независимо от того, какой сервис указан в обычном CLI-режиме.
Для кого. Для исследователей, студентов и технических редакторов, которым нужна двуязычная версия научной статьи без потери верстки.
Подходит, если
- Нужно перевести научный PDF, сохранив формулы и структуру страницы
- Нужно дать агенту возможность переводить PDF по запросу через MCP
- Нужен пакетный перевод через CLI или Docker без ручной работы в интерфейсах
Не подходит, если
- Документ не научный и верстка не важна, проще обычный переводчик текста
- Нет доступа ни к одному из поддерживаемых сервисов перевода и нет времени настраивать локальный вариант
Пример запроса к агенту
Переведи этот научный PDF на русский, сохранив формулы и версткуОграничения
Нужен Python версии от 3.11 до 3.12. Для перевода требуется настроенный сервис перевода, часть из них платные и нужен ключ API. Лицензия AGPL-3.0 налагает требования на производные работы. MCP-режим сейчас всегда переводит через Google, даже если для CLI выбран другой сервис.
Как отключить. Удалите пакет: uv tool uninstall pdf2zh или pip uninstall pdf2zh, и уберите запись MCP-сервера из конфигурации агента.
MCP
- Транспорт
- stdio, sse
- Авторизация
- не нужна
Проверка безопасности
- Отправляет содержимое документа во внешний сервис перевода
- Часть сервисов перевода требует платного API-ключа
Коротко о README
README описывает инструмент как перевод научных PDF с сохранением формул, диаграмм, оглавления и аннотаций, доступный как командная строка, веб-интерфейс и Docker. Раздел с опциями CLI отдельно называет флаги --mcp для режима stdio и --mcp --sse для SSE. Проект принят как демонстрация на конференции EMNLP 2025, есть публичный бесплатный онлайн-сервис pdf2zh.com. Лицензия AGPL-3.0.
Частые вопросы
Какие сервисы перевода поддерживаются?
README перечисляет несколько сервисов на выбор через флаг -s, включая Google и другие, но конкретный MCP-инструмент translate_pdf сейчас всегда использует Google.
Работает ли без VPN из России?
Зависит от выбранного сервиса перевода: сервис Google, который жестко используется в MCP-режиме, из России обычно требует VPN.
Похожие
Утилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели
Скиллы Anthropic
Skills
Официальные примеры скиллов Anthropic: документы docx, pdf, pptx, xlsx, дизайн, MCP builder и спецификация Agent Skills
Скилл, который собирает редактируемые PPTX-презентации из PDF, DOCX, ссылок и Markdown с настоящими фигурами, диаграммами и анимациями
Скилл рисует редакторские диаграммы как самостоятельные файлы HTML и SVG: архитектура, блок-схемы, ER, воронки и еще около сорока типов