overleaf-paper-mcp

Servidor MCP para gestionar proyectos académicos de LaTeX en Overleaf: crear proyectos, transferir archivos, compilar documentos, inspeccionar la salida del compilador y descargar PDFs.

Instalación

Requisitos: Node.js 20+ y Playwright Chromium.

npm install
npx playwright install chromium
npm run build

Ejecute el paquete publicado con:

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

Related MCP server: overleaf-mcp

Configuración

Proporcione las credenciales como variables de entorno en tiempo de ejecución; no incluya un archivo .env en el control de versiones.

Use rutas absolutas para local_path y zip_path siempre que sea posible. Las rutas relativas solo se aceptan dentro de OVERLEAF_DATA_DIR/workspace (o la heredada OVERLEAF_WORKSPACE_DIR). Con OVERLEAF_DATA_DIR, todo el estado local se mantiene bajo un único directorio:

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

No suba ni comparta browser-data/: puede contener su sesión de inicio de sesión de Overleaf. Elimine workspace/ para borrar las descargas, browser-data/ para cerrar sesión, o el directorio de datos completo para restablecer el MCP.

Flujo de trabajo

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

Ante un fallo de compilación visible, overleaf_compile limpia los archivos en caché, reintenta una vez y devuelve los diagnósticos analizados junto con el registro del compilador si el reintento también falla.

overleaf_upload_file actualmente escribe en la raíz del proyecto. Para importar un archivo de proyecto completo, use overleaf_create_project_from_zip.

Herramientas

Configuración de 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

Licencia

MIT