Skip to main content
Glama
Josetoespinosa

GoLatex MCP Server

by Josetoespinosa
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

GoLatex

Workspace LaTeX local con dos caras sobre el mismo motor:

  • Humana: app tipo Overleaf local — árbol de archivos, editor con resaltado LaTeX y visor PDF con SyncTeX, todo en el navegador.

  • Agéntica: servidor MCP que expone el proyecto abierto (leer/escribir archivos, compilar con errores parseados, ver páginas del PDF como imagen) para Claude Code u otro cliente MCP. Ambas caras comparten proyecto, cola de compilación y eventos en vivo: lo que escribe el agente aparece al instante en la app.

Todo local: sin base de datos, sin cuentas, sin nube.

Requisitos

  • macOS con TeX Live en /Library/TeX/texbin (latexmk, synctex).

  • Python 3.11+.

Related MCP server: MagicTeX MCP Server

Arrancar

./run.sh                      # abre http://localhost:8123 (último proyecto)
./run.sh /ruta/a/mi/proyecto  # abre esa carpeta directamente

La primera vez crea .venv e instala dependencias. Puerto configurable con GOLATEX_PORT.

Uso (cara humana)

  • Abrir proyecto: botón 📁 (recientes o explorador de carpetas).

  • Editar: clic en un .tex/.bib del árbol. ⌘S guarda. Pestañas con indicador de cambios sin guardar.

  • Compilar: botón ▶ o ⌘⏎ (raíz configurable con el selector ★; por defecto main.tex). El visor PDF se refresca manteniendo página y zoom.

  • Problemas: panel inferior con errores/warnings clicables (saltan al código); pestaña "Log crudo" con el log completo.

  • SyncTeX: ⌥+clic (o doble clic) sobre el PDF salta a la línea de código; ⌘⌥J en el editor salta del código al PDF.

  • Auto: casilla "auto" recompila con cada guardado. 🌙 alterna modo oscuro.

  • Árbol: clic derecho para crear/renombrar/eliminar (va a la Papelera) y fijar el .tex principal.

Si un agente (u otro editor) modifica un archivo, el editor lo recarga al instante; si tenías cambios sin guardar, aparece un aviso para decidir. Si se recompila, el PDF se actualiza solo.

Conectar el MCP a Claude Code (cara agéntica)

Con la app corriendo (./run.sh):

claude mcp add --transport http golatex http://localhost:8123/mcp

Para Claude Desktop u otros clientes, registra la URL http://localhost:8123/mcp (transporte Streamable HTTP).

Herramientas expuestas (siempre restringidas a la carpeta del proyecto abierto):

Tool

Qué hace

project_info

raíz, main, lista de \input, ¿PDF al día?, páginas

list_files

árbol del proyecto (sin artefactos)

read_file / write_file

leer / escribir un archivo

edit_file

reemplazo puntual (old → new, con control de unicidad)

compile

latexmk; devuelve ok, errores parseados (archivo, línea, mensaje) y páginas

get_log

log crudo completo, bajo demanda

render_page

página N del PDF como imagen PNG (para ver el resultado)

search

grep (regex) sobre los archivos de texto del proyecto

bib_list / bib_add

listar / agregar entradas de references.bib

ai_check

estima qué tan "IA" suena un .tex del proyecto (o texto directo): score 0–1, párrafos sospechosos y señales (detector local texthumanize, sin red). Orientativo: ningún detector de IA es concluyente

Ejemplo de sesión con el agente: "agrega un typo deliberado en capitulo_4.tex, compílalo, léeme el error, arréglalo y recompila" — cada cambio y compilación se ve en vivo en la app.

Nota: el MCP opera sobre el proyecto abierto en la app (una sola sesión y cola de compilación compartida: si el humano y el agente compilan a la vez, se encolan y no se pisan).

Estructura

run.sh            arranque (venv + uvicorn + abrir navegador)
server/           FastAPI: REST + WebSocket + watcher + MCP (/mcp)
web/              UI estática: CodeMirror + PDF.js (vendorizados)

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers