Latex MCP

🚀 LaTeX MCP 服务器

LaTeX MCP 服务器是一个用于 LaTeX 编译和文档生成的模型上下文协议（MCP）服务器，它能帮助用户高效地完成 LaTeX 文档的编译与生成工作。

✨ 主要特性

• LaTeX 编译：可使用多种引擎（pdflatex、xelatex、lualatex）将 LaTeX 源文件编译为 PDF。
• 模板系统：方便管理可重复使用的 LaTeX 模板。
• 代码片段/宏：支持使用预定义的 LaTeX 组件（如方程式、图形、选择题等）。
• 自动清理：在编译过程中自动清理旧文件。
• 缓存机制：对已编译的文档进行缓存，避免重复编译。
• 安全保障：会阻止危险的 LaTeX 命令。

📦 安装指南

Docker（推荐）

1. 构建镜像：

docker build -f Dockerfile.simple -t mcp-latex-simple .

2. 运行容器：

docker run -d --name mcp-latex-server --restart unless-stopped -p 8083:8080 mcp-latex-simple

手动安装

1. 安装系统依赖：

# 安装 LaTeX
sudo apt-get install texlive-latex-base texlive-fonts-recommended texlive-latex-extra

# 安装 Python 依赖
pip install fastmcp jinja2 pydantic pyyaml uvicorn

2. 运行服务器：

python server.py

📚 详细文档

MCP 工具

核心工具

• compile_latex - 将 LaTeX 源文件编译为 PDF。
• list_templates - 列出可用的 LaTeX 模板。
• get_template - 获取模板源代码。

代码片段系统

• list_snippets - 列出可用的 LaTeX 代码片段/宏。
• get_snippet_info - 获取代码片段的详细信息，包括参数。
• render_snippet - 使用提供的参数渲染代码片段。

可用代码片段

• multiple_choice - 创建带有 4 个选项的选择题。
• equation - 创建带编号的方程式，可选择添加标签。
• figure - 创建带标题的图形，可选择添加标签。

配置

设置环境变量：

• PORT - 服务器端口（默认值：8080）。
• LATEX_BASE_URL - 编译文件的基础 URL。
• LATEX_MAX_FILE_AGE_HOURS - 文件清理的时间（小时，默认值：24）。

与 Claude 配合使用

配置 Claude Desktop 以连接到您的 MCP 服务器：

• URL: https://your-domain.com/
• 传输协议: HTTP

API

服务器在配置的端口和路径上公开了一个模型上下文协议接口。

安全

• 阻止危险的 LaTeX 命令。
• 限制文件系统访问。
• 编译过程中不允许进行 shell 转义。
• 自动清理可防止磁盘空间问题。

开发

可参考包含的配置文件：

• docker-compose-standalone.yml - Docker Compose 设置。
• mcp-latex.service - Systemd 服务。
• nginx-include.conf - Nginx 配置。