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 配置。