Overleafmcp

🚀 Overleaf MCP Server

Overleaf MCP Serverは、Git統合を通じてOverleafプロジェクトにアクセスできるMCP（Model Context Protocol）サーバーです。これにより、Claudeや他のMCPクライアントは、LaTeXファイルを読み取り、ドキュメント構造を分析し、Overleafプロジェクトからコンテンツを抽出することができます。

✨ 主な機能

• 📄 ファイル管理：Overleafプロジェクトのファイルを一覧表示および読み取ります。
• 📋 ドキュメント構造解析：LaTeXのセクションとサブセクションを解析します。
• 🔍 コンテンツ抽出：タイトルで特定のセクションを抽出します。
• 📊 プロジェクト概要：プロジェクトの状態と構造の概要を取得します。
• 🏗️ 複数プロジェクト対応：複数のOverleafプロジェクトを管理します。

📦 インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. プロジェクトの設定をセットアップします。

   cp projects.example.json projects.json
   

4. projects.jsonを編集し、Overleafの認証情報を入力します。

   {
     "projects": {
       "default": {
         "name": "My Paper",
         "projectId": "YOUR_OVERLEAF_PROJECT_ID",
         "gitToken": "YOUR_OVERLEAF_GIT_TOKEN"
       }
     }
   }
   

Overleafの認証情報の取得方法

1. Gitトークン：
   • Overleafのアカウント設定 → Git統合に移動します。
   • 「トークンを作成」をクリックします。
2. プロジェクトID：
   • Overleafのプロジェクトを開きます。
   • URL https://www.overleaf.com/project/[PROJECT_ID] から取得します。

Claude Desktopの設定

Claude Desktopの設定ファイルに以下を追加します。

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Linux：~/.config/claude/claude_desktop_config.json

{
  "mcpServers": {
    "overleaf": {
      "command": "node",
      "args": [
        "/path/to/OverleafMCP/overleaf-mcp-server.js"
      ]
    }
  }
}

設定後、Claude Desktopを再起動します。

利用可能なツール

list_projects

設定されたすべてのプロジェクトを一覧表示します。

list_files

プロジェクト内のファイルを一覧表示します（デフォルト: .texファイル）。

• extension：ファイル拡張子のフィルター（オプション）
• projectName：プロジェクト識別子（オプション、デフォルトは "default"）

read_file

プロジェクトから特定のファイルを読み取ります。

• filePath：ファイルのパス（必須）
• projectName：プロジェクト識別子（オプション）

get_sections

LaTeXファイルのすべてのセクションを取得します。

• filePath：LaTeXファイルのパス（必須）
• projectName：プロジェクト識別子（オプション）

get_section_content

特定のセクションのコンテンツを取得します。

• filePath：LaTeXファイルのパス（必須）
• sectionTitle：セクションのタイトル（必須）
• projectName：プロジェクト識別子（オプション）

status_summary

プロジェクトの包括的な状態概要を取得します。

• projectName：プロジェクト識別子（オプション）

💻 使用例

基本的な使用法

# すべてのプロジェクトを一覧表示する
list_projectsツールを使用する

# プロジェクトの概要を取得する
status_summaryツールを使用する

# main.texファイルを読み取る
filePath: "main.tex" でread_fileを使用する

# Introductionセクションを取得する
filePath: "main.tex" とsectionTitle: "Introduction" でget_section_contentを使用する

# ファイル内のすべてのセクションを一覧表示する
filePath: "main.tex" でget_sectionsを使用する

高度な使用法

複数のプロジェクトを扱うには、projects.jsonに追加します。

{
  "projects": {
    "default": {
      "name": "Main Paper",
      "projectId": "project-id-1",
      "gitToken": "token-1"
    },
    "paper2": {
      "name": "Second Paper", 
      "projectId": "project-id-2",
      "gitToken": "token-2"
    }
  }
}

その後、ツールの呼び出しでプロジェクトを指定します。

projectName: "paper2", filePath: "main.tex", sectionTitle: "Methods" でget_section_contentを使用する

ファイル構造

OverleafMCP/
├── overleaf-mcp-server.js    # メインのMCPサーバー
├── overleaf-git-client.js    # Gitクライアントライブラリ
├── projects.json             # あなたのプロジェクト設定（gitignored）
├── projects.example.json     # 設定例
├── package.json              # 依存関係
└── README.md                 # このファイル

セキュリティに関する注意事項

⚠️ 重要提示

• projects.json はGit管理から除外されており、あなたの認証情報を保護します。
• 実際のプロジェクトIDやGitトークンをコミットしないでください。
• 提供されている projects.example.json をテンプレートとして使用してください。

📄 ライセンス

MIT License