latex-mcp

latex-mcp

SepineTamAGPL-3.0
2 звёзд
MCP-сервер для компиляции TeX-файлов внутри Docker-контейнера. AI-ассистент запускает сборку LaTeX-документов прямо во время диалога. Сервер для разработчиков документации, исследователей и DevOps-инженеров. Автоматизирует сборку PDF-отчётов, статей, слайдов. Всё работает в изолированном окружении — не нужно устанавливать полноценную LaTeX-систему на хост.
Ai-mlDevelopmentCloud-devopsDocker
Открыть на GitHub

Установка

uvx latex-mcp

Характеристики

Общее

  • СтатусСообщество
  • РазработчикSepineTam
  • ЛицензияAGPL-3.0

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Компилирует .tex-файлы в PDF через pdflatex, lualatex, xelatex
  • Собирает многофайловые проекты — учитывает преамбулы, библиографию, вложенные include
  • Запускает компиляцию в чистом Docker-контейнере с полным TeX Live
  • Возвращает готовый PDF или лог ошибок компилятора
  • Работает с относительными путями — автоматически монтирует текущую директорию через переменную ${PWD}
  • Не требует установки LaTeX-пакетов на хост-машине
  • Каждый запуск начинается с нового контейнера без сохранения состояния
  • Совместим с любым MCP-клиентом, поддерживающим stdio

Как подключить

Перед началом убедитесь, что на машине установлен Docker и выделено не менее 4 ГБ оперативной памяти.

Установка через uvx

Выполните команду:

uvx latex-mcp

В конфигурационном файле Claude Desktop (claude_desktop_config.json) укажите:

{ "mcpServers": { "latex-mcp": { "command": "uvx", "args": ["latex-mcp"] } } }

Запуск через Docker

Этот способ подходит для командной работы — конфигурация с ${PWD} работает на разных машинах. Создайте в корне проекта файл .mcp.json:

{ "mcpServers": { "latex-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "--mount", "type=bind,src=${PWD},dst=${PWD}", "-w", "${PWD}", "ghcr.io/sepinetam/latex-mcp:latest" ] } } }

После добавления конфигурации перезапустите клиент (Claude Desktop или Claude Code). Сервер готов к работе.

Примеры запросов

  • «Скомпилируй файл main.tex из папки /doc и покажи получившийся PDF»
  • «Запусти latexmk с опцией -pdf для проекта с библиографией»
  • «Найди ошибки в отчёте — при компиляции вылетают undefined references»
  • «Обнови все .tex-файлы в проекте и сгенерируй финальную версию документа»

Технические детали

  • Язык: Python
  • Транспорт: stdio
  • Лицензия: AGPL-3.0
  • Совместимые клиенты: Claude Desktop, Claude Code, любые MCP-клиенты со стандартным вводом-выводом
  • Необходим Docker, рекомендуется от 4 ГБ ОЗУ
  • Образ загружается из GitHub Container Registry

Поделиться