dr-mcp

dr-mcp

MCP を整理しましょう。

dr-mcp は、日々エージェント型のコーディングを行う開発者向けの、ローカル優先の MCP 監査・クリーンアップツールです。ツールが読み込む Model Context Protocol の設定をスキャンし、古いサーバー、放置されたパッケージ、重複エントリ、コンテキストを大量に消費するツール、リスクのある権限、メジャーアップグレードを検出して、元に戻せるパッチプランを生成します。

複数のプロジェクトで Claude Code、OpenAI Codex、Cursor、Windsurf、GitHub Copilot、VS Code、Cline、Roo Code、Continue、Zed を使っていると、MCP の設定はいつの間にか膨らみます。古いデモ用サーバー、重複した GitHub ツール、広範なファイルシステムへのアクセス、npm latest より古いバージョンに固定されたパッケージ、放置されたリポジトリ、コードを書く前にエージェントが検討しなければならない膨大なツール群などです。

dr-mcp は、スキャン中に何も削除せずに、クリーンアップが必要な項目を提示します。

npx @inferensys/dr-mcp cleanup

これにより、現在のプロジェクトでローカルクリーンアップスキャンが開始されます。秘匿情報を除いたレポート、コンテキストを大量に消費する MCP の優先度付きリスト、パッケージとリポジトリの鮮度を示すシグナル、確認後に適用できるパッチプランが得られます。

パッケージ／リポジトリのチェックとローカルインストール履歴の追跡を含む、完全なクリーンアップスキャンを行うには：

npx @inferensys/dr-mcp cleanup --registry --track-usage

Claude Code、Codex、Cursor、Windsurf、GitHub Copilot、またはサーバーのプロンプト／ツールを公開する任意の MCP クライアント内で、dr_mcp_scan または dr_mcp_cleanup を使用します。クライアントが MCP プロンプトをスラッシュコマンドにマッピングする場合は、/dr-mcp scan を使用します。

MCP を整理する理由

MCP サーバーは、ツールをエージェントのループに直接組み込めるため強力です。一方で、サーバーが増えるたびに、ツール選択時のノイズ、コンテキストウィンドウの圧迫、起動失敗、古い依存関係、あるいは今後は付与するつもりのない権限が増える可能性があります。

dr-mcp は、次のことに役立ちます：

• MCP 監査： グローバルとプロジェクトの MCP 設定をまとめたレポートを作成します。
• MCP クリーンアップ： 重複、使用されていないエントリ、放置されたパッケージ、長期間インストールされたままの項目、肥大化したツール群の候補を確認できます。
• MCP コンテキストの整理： すべてのコーディングセッションに不要なサーバーについて、ツール数とコンテキスト負荷を推定します。
• MCP セキュリティレビュー： 広範なファイルシステムへのアクセス、設定内のシークレット、シークレットらしき引数、参照切れの環境変数を確認します。
• MCP アップグレード計画： npm latest との差分をセマンティックバージョニングに基づいて検出し、レビューが必要なメジャーアップグレードも確認できます。
• MCP 修復プラン： 書き込み前にバックアップと差分を含む操作内容を明示します。

修正に役立つこと

• コンテキストを取り戻します。 エージェントのプロンプトに最も多くのツールを追加する MCP を確認できます。
• 不要なツール呼び出しを減らします。 プロジェクトで必要がない場合でもエージェントが検討し続ける古いサーバーを削除できます。
• 放置された MCP を整理します。 --registry を使って、npm のメタデータと GitHub のアクティビティから、アーカイブ済みまたは更新が止まったプロジェクトを確認できます。
• メジャーアップグレードを把握します。 npm latest より大幅に古いバージョンに固定された MCP パッケージを見つけ、アップグレードプランを確認できます。
• 残存項目を見つけます。 --track-usage を有効にすると、スキャンのたびに繰り返し見つかる MCP を記録するローカルの台帳を作成できます。
• 重複を削除します。 Claude、Cursor、VS Code、Codex、Windsurf、またはプロジェクトファイルに登録された同じ MCP を検出できます。
• リスクのある設定を修正します。 広範なファイルシステムへのアクセス、設定内のシークレット、シークレットらしき引数、コマンドの欠落、参照切れのパス、参照切れの環境変数を検出します。
• バージョンが固定されていないインストールを防ぎます。 latest またはバージョン指定なしの npx パッケージを検出します。

監査の仕組み

dr-mcp は、実用的な静的解析とパッケージメタデータのチェックを行います。

1. Claude Desktop、Claude Code、Codex、Cursor、Windsurf、GitHub Copilot、VS Code、Cline、Roo Code、Continue、Zed、および .mcp.json の設定ファイルを検出します。
2. JSON、TOML、YAML の設定形式を解析して正規化し、単一の内部 MCP サーバーモデルにまとめます。
3. 信頼性、セキュリティ、コンテキストの整理状況、保守性の観点からセットアップを評価します。
4. npm のメタデータ、semver による分類、dist-tags.latest、および任意の公式レジストリとの照合を使用して、パッケージの最新状況を確認します。
5. GitHub、ブラウザー自動化、Slack、Jira、ファイルシステム、データベースなど、対象範囲の広い MCP のツール数を推定するヒューリスティックを用いて、コンテキストの占有量を推定します。
6. リポジトリのメタデータが利用可能な場合は、GitHub のアーカイブ状態と最近のプッシュ状況から、メンテナンス状況を確認します。
7. JSON Pointer の対象、冪等な操作、タイムスタンプ付きバックアップ、差分を含むパッチプランを生成します。

コマンド

# Local audit in the current project
npx @inferensys/dr-mcp

# Deeper cleanup report with package/repo checks and local install history
npx @inferensys/dr-mcp cleanup

# Full scan alias for agent workflows
npx @inferensys/dr-mcp scan --deep

# Local-only cleanup flow with no network checks or usage ledger writes
npx @inferensys/dr-mcp cleanup --local

# JSON for scripts or CI
npx @inferensys/dr-mcp scan --workspace . --json --registry

# Shareable cleanup report
npx @inferensys/dr-mcp report --workspace . --format html > dr-mcp-report.html

# Preview a repair plan
npx @inferensys/dr-mcp patch --workspace . --plan remove-duplicate-servers
npx @inferensys/dr-mcp patch --workspace . --plan upgrade-stale-packages

# Apply a reviewed repair plan with backups
npx @inferensys/dr-mcp patch --workspace . --plan remove-duplicate-servers --apply

# Run as an MCP server
npx @inferensys/dr-mcp server

レポートのセクション

• スコア： 信頼性、セキュリティ、コンテキストの整理状況、保守性。
• パッケージのアップグレード： メジャーアップグレードを含む、npm の最新バージョンより古い MCP パッケージの固定バージョン。
• コンテキストの占有量： 推定ツール負荷に基づく MCP のランキング。
• インストール履歴： ローカルの使用状況台帳に記録された、長期間インストールされているサーバー。
• 検出事項： 設定ファイルのパスを含む具体的な問題。
• パッチプラン： 重複、不要なエントリ、放棄されたサーバー、コンテキストの占有量が大きいサーバーの削除など、安全な編集。

クリーンアッププラン

dr-mcp は、検出事項とアクションを分けて扱います。検出事項は問題と思われる内容を示し、パッチプランは実行できる具体的な設定編集を示します。

• remove-duplicate-servers：最初に有効になっている定義を残し、重複する MCP サーバーのエントリを削除します。
• remove-dead-servers：起動できないエントリ、または npm に存在しないパッケージを削除します。
• upgrade-stale-packages：MCP パッケージの参照を npm の最新バージョンに更新します。
• remove-abandoned-servers：アーカイブ済み、または放棄されたリポジトリのサーバーを削除します。
• remove-heavy-context-servers：すべてのセッションで多数のツールを読み込むと推定されるサーバーを削除します。
• remove-long-lived-servers：複数回の追跡スキャンを通じてインストールされたままのサーバーについて、不要になったことを確認した後に削除します。

対応ツール

ツール	スキャン対象の設定
Claude Desktop	claude_desktop_config.json
Claude Code / cc	~/.claude.json、~/.claude/settings.json、.claude/settings.json
OpenAI Codex	~/.codex/config.toml、.codex/config.toml
Cursor	~/.cursor/mcp.json、.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json、.windsurf/mcp.json
VS Code の GitHub Copilot	VS Code のユーザー設定、VS Code Insiders の設定、.vscode/mcp.json、.vscode/settings.json
GitHub Copilot CLI	~/.copilot/mcp-config.json、.copilot/mcp-config.json
Cline	~/.cline/data/settings/cline_mcp_settings.json、.cline/data/settings/cline_mcp_settings.json
Roo Code	.roo/mcp.json、一般的な Roo Code の VS Code グローバルストレージパス
Continue	~/.continue/config.yaml、.continue/config.yaml
Zed	Zed のユーザー設定、.zed/settings.json
汎用 MCP	.mcp.json

エージェントに dr-mcp を追加する

追加したら、セッション内で最短のアクションから始めます。

dr_mcp_scan

クリーンアップ候補、アップグレード、放棄されたサーバー、長期間インストールされているものを確認するには、次を実行します。

dr_mcp_cleanup

MCP プロンプトをスラッシュコマンドとして公開するクライアントでは、dr_mcp_scan、dr_mcp_cleanup、または /dr-mcp scan のようなプロンプトとして表示されることがあります。

Codex

codex mcp add dr-mcp -- npx -y @inferensys/dr-mcp server

Claude Code

claude mcp add dr-mcp -- npx -y @inferensys/dr-mcp server

JSON 設定のクライアント

Claude Desktop、Cursor、Windsurf、Cline、Roo Code、VS Code、および VS Code の GitHub Copilot では、次を使用します。

{
  "mcpServers": {
    "dr-mcp": {
      "command": "npx",
      "args": ["-y", "@inferensys/dr-mcp", "server"]
    }
  }
}

VS Code と GitHub Copilot では servers を使用することがあります。

{
  "servers": {
    "dr-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@inferensys/dr-mcp", "server"]
    }
  }
}

Zed

{
  "context_servers": {
    "dr-mcp": {
      "command": "npx",
      "args": ["-y", "@inferensys/dr-mcp", "server"]
    }
  }
}

Continue

mcpServers:
  dr-mcp:
    command: npx
    args:
      - -y
      - @inferensys/dr-mcp
      - server

MCP ツール

サーバーとして実行すると、dr-mcp は次のツールを公開します。

• dr_mcp_scan
• dr_mcp_cleanup
• scan_mcp_setup
• explain_issue
• generate_patch_plan
• apply_patch_plan
• export_report

MCP プロンプト

• action=scan または action=cleanup を指定した dr_mcp
• dr_mcp_scan
• dr_mcp_cleanup

安全性

スキャンによって MCP クライアントの設定が編集されることはありません。

パッチ計画では、書き込み前にタイムスタンプ付きのバックアップを作成します。レポートでは、シークレット、トークン、メールアドレス、ホームディレクトリのパス、非公開の GitHub リポジトリの URL が伏せられます。

使用状況の追跡はオプトイン方式です。--track-usage を指定すると、ローカルの台帳 ~/.dr-mcp/usage-ledger.json に書き込みます。スキャンをまたいでインストール状態を追跡しますが、クライアントがデータを提供しない限り、ツールごとの実際の使用状況を示すものではありません。

dr-mcp は、パッケージの自動インストール、アンインストール、アップグレード、破壊的なクリーンアップを行いません。

開発

npm install
npm run check
node dist/cli.js scan --workspace tests/fixtures/mixed --json

レジストリ名：io.github.Inferensys/dr-mcp

パッケージ：@inferensys/dr-mcp