/ Directorio / Playground / OverleafMCP
● Comunidad mjyoo2 🔑 Requiere tu clave

OverleafMCP

por mjyoo2 · mjyoo2/OverleafMCP

Lee y edita proyectos de LaTeX en Overleaf desde Claude — ediciones a nivel de sección enviadas por el puente Git, sin necesidad de la UI web.

OverleafMCP conecta Claude con Overleaf a través de la integración Git de Overleaf. Claude puede listar los archivos del proyecto, analizar la estructura LaTeX (secciones, citas, figuras) y enviar ediciones quirúrgicas de vuelta. Diseñado para académicos y escritores técnicos que prefieren iterar desde su editor en lugar de luchar con el área de texto web de Overleaf.

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

overleaf-mcp.replay ▶ listo
0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "overleaf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ],
      "env": {
        "OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
        "OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
      }
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "overleaf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ],
      "env": {
        "OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
        "OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
      }
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "overleaf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ],
      "env": {
        "OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
        "OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
      }
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "overleaf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ],
      "env": {
        "OVERLEAF_PROJECT_URL": "https://www.overleaf.com/project/<id>",
        "OVERLEAF_GIT_TOKEN": "your_overleaf_git_token"
      }
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "overleaf-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@mjyoo2/overleaf-mcp"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json
{
  "context_servers": {
    "overleaf-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mjyoo2/overleaf-mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add overleaf-mcp -- npx -y @mjyoo2/overleaf-mcp

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: OverleafMCP

Compactar una sección del paper sin salir de Claude

👤 Investigadores, escritores técnicos ⏱ ~20 min intermediate

Cuándo usarlo: El Revisor 2 dijo que la sección 3 es verbosa — tienes 30 minutos para arreglarlo.

Requisitos previos
  • Plan de pago de Overleaf con acceso Git — Account → Account Settings → Git authentication
Flujo
  1. Localizar
    Usa el MCP de Overleaf. Encuentra la sección 3 en main.tex. Muéstrame el texto actual.✓ Copiado
    → Texto de la sección devuelto con rango de líneas
  2. Reescribir
    Compacta esto un 30%. Mantén los términos técnicos intactos. No elimines citas.✓ Copiado
    → Reescritura más corta que preserva las citas
  3. Enviar
    Reemplaza la sección 3 con la reescritura. Haz commit con el mensaje 'Compactar §3 por revisor 2'.✓ Copiado
    → Git push exitoso; el proyecto se vuelve a renderizar en Overleaf

Resultado: Las ediciones llegan a Overleaf; no tocaste la UI web.

Errores comunes
  • Ediciones concurrentes de un coautor provocan merge — Haz pull antes de push; resuelve conflictos en Claude con contexto de diff
Combinar con: filesystem

Auditar las citas de un paper

👤 Autores finalizando un manuscrito ⏱ ~15 min beginner

Cuándo usarlo: Antes de enviar — quieres asegurarte de que cada \cite tiene una entrada .bib correspondiente.

Flujo
  1. Inventario
    Lista cada clave \cite{} en main.tex. Cruza con refs.bib.✓ Copiado
    → Tabla de coincidencias; huérfanos marcados
  2. Corregir
    Para cada clave huérfana, sugiere la coincidencia más cercana del .bib o márcala como faltante.✓ Copiado
    → Recomendación por huérfano

Resultado: Cero citas rotas antes de hacer clic en Enviar.

Errores comunes
  • Las citas dentro de comentarios también coinciden — Elimina los comentarios de LaTeX antes del regex

Mover secciones con confianza

👤 Autores reestructurando capítulos ⏱ ~30 min advanced

Cuándo usarlo: El flujo de secciones es incorrecto; quieres intercambiar las secciones 2 y 4.

Flujo
  1. Mapear
    Muéstrame el árbol de secciones de main.tex con rangos de líneas.✓ Copiado
    → Árbol jerárquico
  2. Reordenar
    Intercambia la sección 2 con la sección 4. Actualiza las referencias internas (\ref) en consecuencia.✓ Copiado
    → Intercambio realizado; referencias verificadas

Resultado: Paper reestructurado que compila limpiamente.

Errores comunes
  • Las referencias hacia adelante se rompen — Compila después de reordenar; Claude puede leer los errores y corregirlos

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

overleaf-mcp + filesystem

Copia de seguridad local del paper antes de ediciones estructurales

Guarda una instantánea del proyecto en /papers/backup/ antes de cualquier cambio estructural.✓ Copiado
overleaf-mcp + github

Espejo en GitHub para revisión con seguimiento de issues

Envía los mismos commits al espejo de GitHub para que los coautores puedan dejar comentarios en PRs.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
list_files (ninguno) Descubrir la estructura del proyecto free
read_file path Obtener un .tex / .bib para inspección free
parse_structure path Obtener un esquema antes de editar free
edit_section path, section_id, new_text Reemplazo quirúrgico free
git_push message Persistir ediciones en Overleaf free

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
El Git de Overleaf tiene rate limiting (sé razonable)
Tokens por llamada
500–10000 dependiendo del tamaño del archivo
Monetario
MCP gratis; se requiere plan de pago de Overleaf para Git
Consejo
Lee secciones, no archivos enteros, al iterar

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Overleaf Git token — repo-level read/write
Almacenamiento de credenciales: Variable de entorno OVERLEAF_GIT_TOKEN
Salida de datos: git.overleaf.com
No conceder nunca: Token access to other people's projects

Resolución de problemas

Errores comunes y soluciones

Autenticación fallida durante git_push

El token puede haber expirado; regéneralo en la configuración de Overleaf

Verificar: git ls-remote con la misma URL+token
Errores de Tree-sitter en LaTeX al analizar

Algunas macros confunden al analizador; recurre a read_file + alcance manual

Push rechazado (non-fast-forward)

Un coautor hizo push; haz pull primero, resuelve, luego push

Alternativas

OverleafMCP vs otros

AlternativaCuándo usarlaContrapartida
VimTeX / TeXShop en localNo necesitas sincronización en la nube para nadaSin colaboración en Overleaf
Editor web de OverleafSolo ediciones ligerasSin acceso de agente; manual

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills