🚀 LaTeX MCP 服务器
LaTeX MCP 服务器是一个用于 LaTeX 编译和文档生成的模型上下文协议（MCP）服务器，它能帮助用户高效地完成 LaTeX 文档的编译与生成工作。
✨ 主要特性
- LaTeX 编译：可使用多种引擎（pdflatex、xelatex、lualatex）将 LaTeX 源文件编译为 PDF。
- 模板系统：方便管理可重复使用的 LaTeX 模板。
- 代码片段/宏：支持使用预定义的 LaTeX 组件（如方程式、图形、选择题等）。
- 自动清理：在编译过程中自动清理旧文件。
- 缓存机制：对已编译的文档进行缓存，避免重复编译。
- 安全保障：会阻止危险的 LaTeX 命令。
📦 安装指南
Docker（推荐）
- 构建镜像：
docker build -f Dockerfile.simple -t mcp-latex-simple .
- 运行容器：
docker run -d --name mcp-latex-server --restart unless-stopped -p 8083:8080 mcp-latex-simple
手动安装
- 安装系统依赖：
# 安装 LaTeX
sudo apt-get install texlive-latex-base texlive-fonts-recommended texlive-latex-extra
# 安装 Python 依赖
pip install fastmcp jinja2 pydantic pyyaml uvicorn
- 运行服务器：
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 配置。