overleaf-paper-mcp

MCP-Server für die Verwaltung akademischer LaTeX-Projekte in Overleaf: Projekte erstellen, Dateien übertragen, Dokumente kompilieren, Compiler-Ausgabe untersuchen und PDFs herunterladen.

Installation

Voraussetzungen: Node.js 20+ und Playwright Chromium.

npm install
npx playwright install chromium
npm run build

Führen Sie das veröffentlichte Paket aus mit:

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

Related MCP server: overleaf-mcp

Konfiguration

Geben Sie Anmeldedaten als Laufzeit-Umgebungsvariablen an; committen Sie keine .env-Datei.

Verwenden Sie nach Möglichkeit absolute Pfade für local_path und zip_path. Relative Pfade werden nur innerhalb von OVERLEAF_DATA_DIR/workspace (oder des Legacy-OVERLEAF_WORKSPACE_DIR) akzeptiert. Mit OVERLEAF_DATA_DIR wird der gesamte lokale Zustand unter einem Verzeichnis gespeichert:

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

Laden Sie browser-data/ nicht hoch und teilen Sie es nicht: Es kann Ihre Overleaf-Anmeldesitzung enthalten. Löschen Sie workspace/, um Downloads zu leeren, browser-data/, um sich abzumelden, oder das gesamte Datenverzeichnis, um den MCP zurückzusetzen.

Arbeitsablauf

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

Bei einem sichtbaren Kompilierungsfehler löscht overleaf_compile zwischengespeicherte Dateien, versucht es einmal erneut und gibt geparste Diagnosen sowie das Compiler-Protokoll zurück, falls auch der erneute Versuch fehlschlägt.

overleaf_upload_file schreibt derzeit in die Projektwurzel. Um ein vollständiges Projektarchiv zu importieren, verwenden Sie overleaf_create_project_from_zip.

Werkzeuge

Codex-Konfiguration

[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

Lizenz

MIT