Latex MCP

🚀 LaTeX MCP Server

LaTeXのコンパイルとドキュメント生成を行うためのモデルコンテキストプロトコル（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

サーバーは、設定されたポートとパスでモデルコンテキストプロトコルインターフェースを公開します。

🔒 セキュリティ

• 危険なLaTeXコマンドはブロックされます。
• ファイルシステムへのアクセスは制限されます。
• コンパイル中にシェルエスケープは許可されません。
• 自動クリーンアップにより、ディスクスペースの問題が防止されます。

🛠️ 開発

含まれている設定ファイルを参照してください：

• docker-compose-standalone.yml - Docker Composeの設定
• mcp-latex.service - Systemdサービス
• nginx-include.conf - Nginxの設定