overleaf-paper-mcp

MCP-сервер для управления академическими LaTeX-проектами в Overleaf: создание проектов, передача файлов, компиляция документов, просмотр вывода компилятора и загрузка PDF-файлов.

Установка

Требования: Node.js 20+ и Playwright Chromium.

npm install
npx playwright install chromium
npm run build

Запустите опубликованный пакет с помощью:

OVERLEAF_EMAIL="your@email.com" \
OVERLEAF_PASSWORD="yourpassword" \
npx -y @youzhijc/overleaf-paper-mcp

Related MCP server: overleaf-mcp

Конфигурация

Укажите учетные данные как переменные окружения времени выполнения; не сохраняйте файл .env в репозитории.

Используйте абсолютные пути для local_path и zip_path, когда это возможно. Относительные пути принимаются только внутри OVERLEAF_DATA_DIR/workspace (или в устаревшем OVERLEAF_WORKSPACE_DIR). С OVERLEAF_DATA_DIR все локальное состояние хранится в одном каталоге:

OVERLEAF_DATA_DIR/
├── workspace/      # downloaded project files and PDFs
└── browser-data/   # Overleaf login session and browser cache

Не загружайте и не передавайте browser-data/: в нем может содержаться ваш сеанс входа в Overleaf. Удалите workspace/, чтобы очистить загрузки, browser-data/ — чтобы выйти из системы, или весь каталог данных, чтобы сбросить MCP.

Рабочий процесс

overleaf_list_files (optional)
→ overleaf_download_file
→ edit the local file
→ overleaf_upload_file (overwrite: true when replacing a file)
→ overleaf_compile
→ overleaf_download_pdf

При видимом сбое компиляции overleaf_compile очищает кэшированные файлы, повторяет попытку один раз и возвращает разобранные диагностические сообщения, а также журнал компилятора, если повторная попытка тоже не удалась.

overleaf_upload_file в настоящее время записывает файлы в корень проекта. Чтобы импортировать полный архив проекта, используйте overleaf_create_project_from_zip.

Инструменты

Конфигурация Codex

[mcp_servers.overleaf-paper-mcp]
command = "npx"
args = ["-y", "@youzhijc/overleaf-paper-mcp"]
env = {
  OVERLEAF_EMAIL = "your@email.com",
  OVERLEAF_PASSWORD = "yourpassword",
  OVERLEAF_DATA_DIR = "/absolute/path/to/your/overleaf-paper-mcp-data"
}
startup_timeout_sec = 120
tool_timeout_sec = 120

Лицензия

MIT