Repository Public Research preview
1{2 "schemaVersion": "1.0",3 "name": "@spboucher/latex-build-mcp",4 "version": "1.0.1",5 "type": "mcp-server",6 "description": "MCP server that compiles LaTeX without shell escape and checks the result: parsed log diagnostics, overfull boxes, Beamer frames that overflow, references and citations, numbering from the .aux, LaTeX to Word.",7 "license": "MIT",8 "keywords": [9 "latex",10 "latexmk",11 "beamer",12 "xelatex",13 "bibtex",14 "biber",15 "pandoc",16 "docx",17 "manuscript",18 "mcp",19 "build",20 "qa"21 ],22 "compatibility": [23 {24 "client": "claude-code",25 "platform": "any"26 },27 {28 "client": "codex",29 "platform": "any"30 },31 {32 "client": "cursor",33 "platform": "any"34 },35 {36 "client": "generic-mcp",37 "platform": "any"38 }39 ],40 "permissions": [41 "shell",42 "filesystem:read",43 "filesystem:write",44 "env"45 ],46 "mcp": {47 "transport": "stdio",48 "command": "node",49 "args": [50 "server.mjs"51 ],52 "env": [53 {54 "name": "LATEX_MCP_ROOT",55 "description": "Only directory the server reads and writes (default: working directory).",56 "required": false,57 "secret": false58 },59 {60 "name": "LATEX_MCP_TIMEOUT_S",61 "description": "Time limit in seconds for each child process (default 120).",62 "required": false,63 "secret": false64 }65 ],66 "tools": [67 {68 "name": "toolchain_status",69 "description": "Which LaTeX tools are installed, with versions, and what each missing tool disables."70 },71 {72 "name": "compile",73 "description": "Compile to PDF with pdflatex, xelatex or lualatex (latexmk when installed), never with shell escape; returns page count and parsed diagnostics."74 },75 {76 "name": "parse_log",77 "description": "Errors with file and line, warnings, overfull and underfull boxes, undefined references and citations, duplicate labels, missing files and fonts."78 },79 {80 "name": "check_overflow",81 "description": "Overfull boxes above a threshold; for Beamer, the frames whose content runs past the slide, by number and title."82 },83 {84 "name": "beamer_report",85 "description": "Every frame of a deck with title, source line and pages; overflowing frames; frames without a title."86 },87 {88 "name": "audit_references",89 "description": "Undefined references, duplicate and unused labels, unreferenced floats, citations missing from the .bib, unused keys."90 },91 {92 "name": "bib_audit",93 "description": "Expected against actual bibliography backend, entries not found, backend warnings and errors, incomplete entries."94 },95 {96 "name": "word_count",97 "description": "Word count with texcount, or a documented approximation without it."98 },99 {100 "name": "lint",101 "description": "chktex with a curated subset of rules."102 },103 {104 "name": "extract_numbering",105 "description": "Number, page and kind of every label, captions and citation labels, read from the .aux."106 },107 {108 "name": "to_docx",109 "description": "LaTeX to Word through pandoc with cross-reference numbers from the .aux; lists what does not survive."110 },111 {112 "name": "pdf_text",113 "description": "Text of a page range of the compiled PDF."114 },115 {116 "name": "clean_build",117 "description": "Remove the build directory this server created; needs confirm: true."118 },119 {120 "name": "explain_error",121 "description": "Usual cause and fix of a LaTeX, BibTeX or Biber error message."122 }123 ]124 },125 "examples": [126 {127 "title": "Compile and audit a document with planted defects (Claude Code)",128 "client": "claude-code",129 "image": "examples/claude-code.png",130 "alt": "Terminal screenshot of a Claude Code session using latex-build-mcp: the prompt, the tool or script calls, and the agent's answer.",131 "prompt": "Compile main.tex with the latex-build MCP tools and audit it. Report, with file:line, every undefined reference or citation, duplicate label and overfull box. Do not fix anything. At most 14 lines.",132 "caption": "The document compiles; the tools report the undefined reference and citation, the duplicate label and the overfull box with file and line. Real session, Claude Code 2.1.322 with Fable 5.2, with version 1.0.0 installed from this registry; inputs are test fixtures.",133 "capturedAt": "2026-11-10"134 },135 {136 "title": "Compile and audit a document with planted defects (Codex)",137 "client": "codex",138 "image": "examples/codex.png",139 "alt": "Terminal screenshot of a Codex session using latex-build-mcp: the prompt, the tool or script calls, and the agent's answer.",140 "prompt": "Compile main.tex with the latex-build MCP tools and audit it. Report, with file:line, every undefined reference or citation, duplicate label and overfull box. Do not fix anything. At most 14 lines.",141 "caption": "The document compiles; the tools report the undefined reference and citation, the duplicate label and the overfull box with file and line. Real session, Codex CLI 0.167.1 with GPT-6.1-Sol, with version 1.0.0 installed from this registry; inputs are test fixtures.",142 "capturedAt": "2026-11-10"143 }144 ]145}146