Overleaf MCP

Overleaf プロジェクトを Claude から読み書きするための、Overleaf git ブリッジを使用したツールです。

警告: MCP にプロジェクト ID を提供すると、Claude がプロジェクトディレクトリ全体にアクセスできるようになります。

必要条件

• Overleaf プレミアム（所属機関でのアクセスを確認してください！）

• uv、git、TeX ディストリビューション、および pdftocairo（Mac では brew install poppler でインストールできます）

Related MCP server: overleaf-mcp

セットアップ

1. リポジトリをクローンします。

2. ~/.overleaf-mcp/projects.json を作成します。例は projects.json.example にあります。プロジェクト ID は Overleaf の URL の /project/ の後の文字列です。

   { "default": "paper", "projects": { "paper": "<project-id>" } }

3. サーバーを Claude の設定に追加します。git トークンは Overleaf のアカウント設定で生成できます。

   {
     "mcpServers": {
       "overleaf": {
         "command": "/absolute/path/to/uv",
         "args": ["run", "--directory", "/absolute/path/to/overleaf-mcp", "overleaf-mcp"],
         "env": { "OVERLEAF_TOKEN": "your_git_token" }
       }
     }
   }

4. Claude を再起動します。

仕組み

プロジェクトは、open_project が成功するまで unverified と見なされます。open_project は、すべての \usepackage がローカルの TeX 環境で解決できることを確認し、各ルートをベースラインコンパイルします。

すべての書き込みは、open_project が成功するまで拒否されます

\documentclass を含む .tex ファイルは ルート であり、子 は \input/\include/\subfile によってインクルードされます。子を編集すると、それをインクルードするルートが再コンパイルされます。たとえば、標準的な main.tex + sections/ プロジェクト、単一ファイルの論文、または同じルールに従う独立した 1 ページドキュメントのフォルダにも対応します。 さらに、エラーがあるとプッシュがブロックされ、警告は報告されるだけです。

ツール