MCP LaTeX サーバー

LaTeX ファイルの作成、編集、検証、およびコンパイルを行うための Model Context Protocol (MCP) サーバーです。FastMCP と Pydantic を使用して構築されており、型安全で構造化された出力を提供します。

機能

• 作成: パラメータまたはバンドルされたテンプレート（article、beamer、report）から LaTeX ドキュメントを作成

• 編集: 置換、挿入、追記、先頭への追加操作によるファイル編集

• 読み込みおよび一覧表示: セキュアなベースディレクトリ内の .tex ファイルを操作

• 検証: 構文（括弧、環境、参照、必須宣言）の検証

• コンパイル: pdflatex、xelatex、または lualatex を使用した PDF へのコンパイル

• リソース: latex:// URI を介したバンドル済みテンプレートの閲覧と取得

前提条件

• Python 3.11.9 以上

• LaTeX ディストリビューション（コンパイル用）:

  • Windows: MiKTeX または TeX Live

  • macOS: MacTeX (brew install --cask mactex)

  • Linux: sudo apt install texlive-full (Debian/Ubuntu) または sudo dnf install texlive-scheme-full (Fedora)

インストール

uv を使用する場合（推奨）

git clone https://github.com/RobertoDure/mcp-latex-server
cd mcp-latex-server
uv pip install -e .

pip を使用する場合

git clone <repository-url>
cd mcp-latex-server
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS/Linux
source .venv/bin/activate
pip install -e .

クイックセットアップ（Windows）

python quick_setup.py

これにより、Python バージョンの確認、依存関係のインストール、サーバーのインポート確認、およびオプションで Claude Desktop の設定が行われます。

設定

サーバーは単一の環境変数を使用します：

ツールに渡されるすべてのファイルパスは、このベースディレクトリからの相対パスとして解決されます。これより外側へのアクセスは拒否されます。

MCP クライアントの設定

Claude Desktop

claude_desktop_config.json に以下を追加します：

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "latex-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-latex-server",
        "run",
        "latex_server.py"
      ],
      "env": {
        "LATEX_SERVER_BASE_PATH": "/path/to/your/latex/files"
      }
    }
  }
}

VS Code (GitHub Copilot)

ワークスペースの .vscode/mcp.json に以下を追加します：

{
  "servers": {
    "latex-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-latex-server",
        "run",
        "latex_server.py"
      ],
      "env": {
        "LATEX_SERVER_BASE_PATH": "${workspaceFolder}"
      }
    }
  }
}

ツール

create_latex_file

パラメータから新しい LaTeX ドキュメントを作成します。

create_from_template

バンドルされたテンプレートからドキュメントを作成します。

edit_latex_file

既存の LaTeX ファイルを編集します。

read_latex_file

.tex ファイルの内容を読み取って返します。

list_latex_files

ディレクトリ内のすべての .tex ファイルを一覧表示します。

validate_latex

LaTeX 構文（必須宣言、括弧の対応、環境の整合性、未定義の参照）をチェックします。

get_latex_structure

ドキュメント構造（クラス、タイトル、著者、パッケージ、セクション階層）を抽出します。

compile_latex

.tex ファイルを PDF にコンパイルします（参照や目次のためにエンジンを2回実行します）。

リソース

テスト

MCP Inspector でテストします：

uv run mcp dev latex_server.py

または、付属のテストスイートを実行します：

python test_server.py

トラブルシューティング

サーバーが起動しない — Python 3.10 以上 (python --version) であること、および mcp がインストールされていること (pip list | grep mcp) を確認してください。

コンパイルが失敗する — LaTeX ディストリビューションが PATH に含まれていることを確認してください (pdflatex --version)。不足している場合は MiKTeX または TeX Live をインストールしてください。

「Access denied」エラー — 要求されたファイルパスが LATEX_SERVER_BASE_PATH の外側に解決されています。相対パスを使用するか、環境変数を調整してください。

Claude が接続できない — MCP 設定のファイルパスを再確認し、Claude Desktop を再起動し、uv run mcp dev latex_server.py で検証してください。

ライセンス

MIT