PDF Triage

git clone https://github.com/vishalmeena2211/pdf-triage-mcp.git
cd pdf-triage-mcp
npm install
npm run build
node dist/index.js --root ~/Documents

続いて、以下のいずれかの設定で npx の実行部分を "command": "node", "args": ["/absolute/path/to/dist/index.js", ...] に置き換えてください。

設定ファイル

{
  "mcpServers": {
    "pdf-triage": {
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ]
    }
  }
}

確認方法： Claude Desktop を完全に終了してから再起動してください（ウィンドウを閉じるだけではありません）。チャット入力欄の近くにツールアイコンが表示されます。クリックして、4 つの pdf_* ツールが一覧にあることを確認してください。

ログ：~/Library/Logs/Claude/mcp*.log（macOS）、%APPDATA%\Claude\logs\mcp*.log（Windows）。

ドキュメント

CLI — 最も簡単な方法です。 -- 区切り文字は必須です。その後に続くすべての内容がサーバーコマンドになります。

# Just you, this project (default)
claude mcp add pdf-triage -- npx -y pdf-triage-mcp --root /Users/me/Documents

# Just you, every project
claude mcp add --scope user pdf-triage -- npx -y pdf-triage-mcp --root /Users/me/Documents

# Shared with your team, writes .mcp.json to the repo
claude mcp add --scope project pdf-triage -- npx -y pdf-triage-mcp --root /Users/me/Documents

または、プロジェクトルートの .mcp.json を直接編集します。

{
  "mcpServers": {
    "pdf-triage": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ]
    }
  }
}

確認方法： claude mcp list → ✔ Connected が表示されていることを確認します。プロジェクトスコープのサーバーは初回使用時に承認が必要です。セッション内で /mcp を実行してください。

ドキュメント

設定ファイル： .cursor/mcp.json（プロジェクト）または ~/.cursor/mcp.json（グローバル）。競合する場合はプロジェクト側が優先されます。

{
  "mcpServers": {
    "pdf-triage": {
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ]
    }
  }
}

確認方法： Cursor はホットリロードするため、再起動は不要です。Cursor Settings → Tools & MCP を開き、pdf-triage の横に緑色のドットが表示されていることを確認してください。

ドキュメント

設定ファイル： ~/.codeium/windsurf/mcp_config.json（macOS/Linux）、%USERPROFILE%\.codeium\windsurf\mcp_config.json（Windows）。

初回起動時には作成されないため、見つからない場合は自分で作成してください。

{
  "mcpServers": {
    "pdf-triage": {
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ]
    }
  }
}

確認方法： Windsurf はファイルを監視し、保存時にホットリロードします。次のチャットセッションで Cascade にツールが表示されます。

ドキュメント

キーは mcpServers ではなく servers です。 Claude Desktop の設定をコピーする際によくある間違いです。

設定ファイル： .vscode/mcp.json（ワークスペース）、またはコマンドパレット → MCP: Open User Configuration（グローバル）。

{
  "servers": {
    "pdf-triage": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ]
    }
  }
}

CLI を使う方法：

code --add-mcp '{"name":"pdf-triage","command":"npx","args":["-y","pdf-triage-mcp","--root","/Users/me/Documents"]}'

確認方法： MCP ツールは Agent モードでのみ動作します。Copilot Chat で Ask/Edit から Agent に切り替え、Configure Tools をクリックして、pdf_* ツールが表示されることを確認してください。ファイルを初めて追加した後は、VS Code を再起動してください。

ドキュメント

**キーは mcpServers ではなく context_servers です。**また、command は文字列ではなく、ネストされたオブジェクトです。

設定ファイル： ~/.config/zed/settings.json（macOS/Linux）、%APPDATA%\Zed\settings.json（Windows）。コマンドパレット → zed: open settings。

{
  "context_servers": {
    "pdf-triage": {
      "source": "custom",
      "command": {
        "path": "npx",
        "args": [
          "-y", "pdf-triage-mcp",
          "--root", "/Users/me/Documents"
        ],
        "env": {}
      }
    }
  }
}

この形式を Zed のバージョンが受け付けない場合は、ネスト形式より前のバージョンです。代わりに、サーバーオブジェクトのトップレベルで command、args、env をフラットに指定してみてください。

確認方法： Agent Panel（Cmd+Shift+A）→ 歯車アイコン → MCP Servers。緑色のドットは接続済みを示します。

ドキュメント

設定ファイル — VS Code 本体の設定とは別です。

{
  "mcpServers": {
    "pdf-triage": {
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ],
      "disabled": false,
      "autoApprove": ["pdf_classify", "pdf_search"]
    }
  }
}

autoApprove を設定すると、一覧にある読み取り専用ツールは確認プロンプトなしで実行されます。

設定ファイル： ~/.continue/config.yaml（グローバル）または .continue/config.yaml（プロジェクト）。現在は YAML が使われており、config.json は非推奨です。

ここでの mcpServers はオブジェクトではなくリストです。また、YAML ではタブを使わず、スペースを使ってください。

mcpServers:
  - name: pdf-triage
    command: npx
    args:
      - -y
      - pdf-triage-mcp
      - --root
      - /Users/me/Documents

確認方法： 保存すると自動的に再読み込みされます。Continue をエージェントモードに切り替えてください。ほかのモードでは MCP ツールを使用できません。

ドキュメント

CLI：

gemini mcp add pdf-triage npx -y pdf-triage-mcp --root /Users/me/Documents

# global instead of project-scoped
gemini mcp add --scope user pdf-triage npx -y pdf-triage-mcp --root /Users/me/Documents

または ~/.gemini/settings.json（グローバル）／.gemini/settings.json（プロジェクト）を編集します：

{
  "mcpServers": {
    "pdf-triage": {
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ],
      "timeout": 30000,
      "trust": false
    }
  }
}

確認方法： gemini セッション内で /mcp を実行すると、サーバーがツール一覧とともに CONNECTED と表示されます。または、シェルから gemini mcp list を実行します。

ドキュメント

設定ファイル： ~/.codex/config.toml（グローバル）または .codex/config.toml（プロジェクト）。

TOML 形式で、キーは mcp_servers です。スネークケースを使い、mcpServers は使いません。

[mcp_servers.pdf-triage]
command = "npx"
args = [
  "-y", "pdf-triage-mcp",
  "--root", "/Users/me/Documents"
]
startup_timeout_sec = 20
tool_timeout_sec = 60

確認方法： codex doctor --json で設定の構文を検証できます。ただし、検証されるのは構文のみで、サーバーが実際に起動したことは確認されません。

既知の上流の問題： 複数の Codex CLI バージョンには、stdio サーバーの検証は正常に完了するものの、起動に失敗して TUI に Tools: none と表示されるバグがあります（#3441、#26810）。これは Codex のランタイムのバグであり、設定エラーではありません。

ドキュメント

AI Assistant — IDE から設定するため、編集するファイルはありません。

1. Settings → Tools → AI Assistant → Model Context Protocol (MCP)
2. Add → トランスポートに STDIO を選択
3. 次を貼り付けます：

{
  "mcpServers": {
    "pdf-triage": {
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ]
    }
  }
}

4. OK → Apply

Junie はファイルで設定します — ~/.junie/mcp/mcp.json（グローバル）または .junie/mcp/mcp.json（プロジェクト）。JSON の形式は同じです。

確認方法： MCP 設定パネルの Status 列を確認します。クリックすると、サーバーのツール一覧が表示されます。

ドキュメント

設定ファイル： ~/.lmstudio/mcp.json（macOS/Linux）、%USERPROFILE%\.lmstudio\mcp.json（Windows）。

アプリから設定するほうが簡単です：右サイドバー → Program タブ → Install → Edit mcp.json。

{
  "mcpServers": {
    "pdf-triage": {
      "command": "npx",
      "args": [
        "-y", "pdf-triage-mcp",
        "--root", "/Users/me/Documents"
      ]
    }
  }
}

確認方法： 保存すると自動的に再読み込みされます。ツールは Program パネルに表示されます。LM Studio では、モデルが初めてツールを呼び出すときに確認ダイアログが表示されます。

ドキュメント