texlive-mcp

基于 Yeok-c/latex-mcp-server 的本地改造，基线提交 f791130edc4e38bada401ae4c688f121255225da。保留上游 MIT 许可。创作来自GPT

面向本机 Linux、TeX Live 2026：/opt/texlive/bin/x86_64-linux。使用官方 Python MCP SDK，通过 stdio 通信，Python >=3.10，不需要 Node.js。

功能

• texlive_info：检查 TeX Live 版本、编译器与参考文献工具路径。

• list_tex_files、read_file：列出和读取指定工作区内的文件。

• compile_latex：latexmk 自动处理多轮编译、交叉引用、BibTeX/Biber；支持 pdflatex、xelatex（默认）、lualatex；返回 PDF 路径、日志尾部和诊断。

• check_package：使用 kpsewhich 检查本地宏包，不自动安装。

• read_pdf：有页数、字符数、文件大小限制的文本提取；不存在或损坏的文件报错，不伪造内容，不支持 OCR。

Related MCP server: GoLatex MCP Server

启动

先按下方说明创建 .venv 并安装依赖，然后运行：

./.venv/bin/python -m latex_mcp_server.local --workspace /你的论文目录

启动后会等待 MCP 客户端的标准输入，这是正常行为。也可在任意目录直接调用项目内的 run-local.sh（带上述 workspace 参数）。

新机器安装：

python3 -m venv .venv
.venv/bin/pip install -e '.[dev]'

--tex-bin 可覆盖 TeX Live 的 bin 路径。mcp.example.json 提供通用客户端示例，需替换论文目录。此项目没有自动修改全局 MCP 配置。

构建与限制

构建产物写入 .latex-mcp-build/<入口相对路径去后缀>/，TeX 字体缓存也在 .latex-mcp-build/texmf-cache/。子目录入口以入口所在目录为编译工作目录；其中的资源路径应相对此目录。使用编辑器打开返回的 PDF 路径即可预览。

读取工具拒绝绝对路径、../ 越界和指向工作区外的符号链接。编译默认关闭 shell escape、latexmk rc 配置，设置 TeX 的受限文件读写策略，设置超时并杀死编译进程组。不提供任意命令、自动下载、源码改写或清理工具。

这些措施不等于操作系统沙箱：TeX、LuaTeX、参考文献处理器均为本地程序，只编译可信项目。依赖 shell escape 的 minted、外部绘图、定制 .latexmkrc 等流程不会按原方式工作。读取工具的路径校验不防御恶意并发替换符号链接；字体/PDF 解析仍可能消耗资源。错误编译目录里可能留有旧 PDF，必须以返回的 ok 为准。

测试

.venv/bin/python -m pytest tests/test_local.py -q

覆盖三种引擎、中文、BibTeX、Biber、错误诊断、超时、路径/符号链接越界、禁用 rc，以及官方 MCP 客户端握手和调用。上游试验版工具与测试已移除；其原始内容仍保留在 Git 历史。

上游来源

创作来自GPT

上游作者信息和 MIT 许可保留。

不带参数执行 run-local.sh 时，以调用时的当前目录作为论文工作区；也可以显式传入 --workspace。