LaTeX MCP Server

这是一个用于LaTeX编译和文档生成的Model Context Protocol (MCP)服务器。

功能

• LaTeX编译：使用各种引擎（pdflatex、xelatex、lualatex）将LaTeX源代码编译成PDF。
• 模板系统：管理可重复使用的LaTeX模板。
• 片段/宏：使用预定义的LaTeX组件（如方程、图形、多项选择题等）。
• 自动清理：在编译过程中自动清理旧文件。
• 缓存：已编译的文档被缓存以避免重新编译。
• 安全性：阻止危险的LaTeX命令。

MCP工具

核心工具

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

片段系统

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

可用片段

• multiple_choice - 创建具有4个选项的多项选择题。
• equation - 创建带有可选标签的编号方程。
• figure - 创建带有说明文字和可选标签的图形。

安装

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

配置

设置环境变量：

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

使用Claude

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

• URL: https://your-domain.com/
• 传输方式: HTTP

API

服务器通过配置的端口和路径提供Model Context Protocol接口。

安全性

• 阻止危险的LaTeX命令。
• 限制文件系统访问。
• 编译期间不允许shell逃逸。
• 自动清理防止磁盘空间问题。

开发

查看包含的配置文件：

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