PDFMathTranslate MCP
Перевод научных PDF с сохранением формул, таблиц и верстки: CLI, Docker и MCP-сервер для агентов
- 38 388 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Отправляет содержимое документа во внешний сервис перевода
- Часть сервисов перевода требует платного API-ключа
Установка
- Работает в
Ручная установка
pip install uv
uv tool install --python 3.12 pdf2zhУстановка через uv, затем перевод командой pdf2zh document.pdf
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Отправляет содержимое документа во внешний сервис перевода
- Часть сервисов перевода требует платного API-ключа
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Инструмент переводит научные PDF-документы, сохраняя формулы, диаграммы, оглавление и аннотации на месте. Работает как командная строка (pdf2zh document.pdf), веб-интерфейс, Docker-образ и MCP-сервер: флаг --mcp запускает его в режиме stdio, а --mcp --sse в режиме SSE. Поддерживает несколько сервисов перевода на выбор через флаг -s. В коде MCP-инструмента translate_pdf сейчас жестко задан сервис Google, независимо от того, какой сервис указан в обычном CLI-режиме.
Для кого. Для исследователей, студентов и технических редакторов, которым нужна двуязычная версия научной статьи без потери верстки.
Подходит, если
- Нужно перевести научный PDF, сохранив формулы и структуру страницы
- Нужно дать агенту возможность переводить PDF по запросу через MCP
- Нужен пакетный перевод через CLI или Docker без ручной работы в интерфейсах
Не подходит, если
- Документ не научный и верстка не важна, проще обычный переводчик текста
- Нет доступа ни к одному из поддерживаемых сервисов перевода и нет времени настраивать локальный вариант
Пример запроса к агенту
Переведи этот научный PDF на русский, сохранив формулы и версткуMCP
- Транспорт
- stdio, sse
- Авторизация
- не нужна
Ограничения
Нужен Python версии от 3.11 до 3.12. Для перевода требуется настроенный сервис перевода, часть из них платные и нужен ключ API. Лицензия AGPL-3.0 налагает требования на производные работы. MCP-режим сейчас всегда переводит через Google, даже если для CLI выбран другой сервис.
Как отключить. Удалите пакет: uv tool uninstall pdf2zh или pip uninstall pdf2zh, и уберите запись MCP-сервера из конфигурации агента.
Частые вопросы
Какие сервисы перевода поддерживаются?
README перечисляет несколько сервисов на выбор через флаг -s, включая Google и другие, но конкретный MCP-инструмент translate_pdf сейчас всегда использует Google.
Работает ли без VPN из России?
Зависит от выбранного сервиса перевода: сервис Google, который жестко используется в MCP-режиме, из России обычно требует VPN.
Чем PDFMathTranslate отличается от обычных переводчиков PDF?
Он переводит научные PDF с формулами, таблицами и диаграммами на своих местах, сохраняя оглавление и аннотации. Работает как командная строка, веб-интерфейс, Docker-образ и MCP-сервер для агентов.
Как настроить PDFMathTranslate для локальной модели?
Установите инструмент командами pip install uv и uv tool install --python 3.12 pdf2zh, затем выберите сервис перевода в настройках. Список поддерживаемых сервисов и параметры запуска смотрите в блоке установки и в README.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP PDF от ComPDF: агент конвертирует PDF и изображения в Word, Excel, Markdown и JSON, объединяет, режет, защищает и сравнивает файлы через облачный API
MinerU PDF Translate переводит научные PDF на другой язык с формулами и рисунками и отдает готовый PDF.
MCP PDF для больших документов: агент ищет по смыслу и по ключевым словам в одном файле или папке и читает только нужные страницы, таблицы и сканы
MCP-сервер на базе Docling: переводит PDF в структурированный документ, собирает новые документы и загружает их в RAG
MCP-сервер, который превращает PDF, DOCX, XLSX, PPTX, изображения, аудио, веб-страницы и расшифровки YouTube в Markdown
Извлечение PDF с самопроверкой: нечитаемые страницы получают пометку и не пропадают молча, плюс MCP-сервер для Claude
Коротко о README
README описывает инструмент как перевод научных PDF с сохранением формул, диаграмм, оглавления и аннотаций, доступный как командная строка, веб-интерфейс и Docker. Раздел с опциями CLI отдельно называет флаги --mcp для режима stdio и --mcp --sse для SSE. Проект принят как демонстрация на конференции EMNLP 2025, есть публичный бесплатный онлайн-сервис pdf2zh.com. Лицензия AGPL-3.0.