mcp-digger

mcp-digger

AI コーディングエージェント向けのコードコンテキスト。 内部の .NET / NuGet パッケージソースにオンデマンドで段階的にアクセスできます。エージェントは、ワークスペースを一切汚さずに、プライベートな C# ライブラリを自律的に閲覧、検索、読み取ります。

⚠ 対象範囲：.NET / C# のみ。 mcp-digger は、.csproj パッケージと .cs ソースファイルを含む NuGet 形式のリポジトリをインデックス化します。汎用のソースインデクサーではないため、他の言語（TypeScript、Python、Java、Go など）は対象外です。

✨ 導入する理由

パブリックな NuGet パッケージには、API リファレンス、チュートリアル、コミュニティの Q&A などのドキュメントエコシステムがあります。context7 のようなツールは、そうした用途に適しています。

内部の .NET パッケージでは、ソースコードが主要なドキュメントであることがよくあります。mcp-digger はそのソースを、構造化され、検索しやすく、トークン効率のよいコンテキストに変換し、MCP 対応エージェントが利用できるようにします。これにより、プライベートな C# ライブラリエコシステムのドキュメント不足を補います。

導入しない場合：

• 🐢 コンテキストの収集に時間がかかる — git clone、find、grep、cat の連鎖により、有用なコンテキストを取得する前にインフラ関連でトークンを消費します。
• 🔍 セマンティック検索ができない — ファイルシステムツールで見つかるのはテキストであり、API の構造ではありません。「このインターフェイスを実装するすべての型」を調べるには、その都度抽出スクリプトを書く必要があります。
• 💸 トークンの浪費 — メソッドシグネチャが1つあればよい場面でも、エージェントがファイル全体を読み込みます。
• 🖱 権限確認のクリック疲れ — 1回のセッションで、数十件ものシェルコマンドの承認が必要になります。
• 🧹 ワークスペースが煩雑になる — 参照先のリポジトリがファイル検索、git の状態、エージェントのコンテキストウィンドウを汚します。

導入した場合：

• ✅ 最初から正しいコードを記述 — 実際のシグネチャ、ジェネリック制約、インターフェイスの契約、基底クラスのパターンを利用できます。
• ⚡ 必要なコンテキストを自分で取得 — エージェントに NuGet リポジトリを一度指定すれば、自律的に閲覧、検索、読み取りを行います。
• 🪙 段階的な情報開示 — 5,000トークンのソースを読む前に、200トークンの概要を確認できます。ほとんどの質問は L1 または L2 で解決します。
• 🧼 ワークスペースを一切汚さない — 管理対象のクローンはプロジェクトツリーの外に配置されます。
• 🌐 あらゆる Git ホストに対応 — GitHub、GitLab、Azure DevOps、Bitbucket、セルフホスト環境に HTTPS または SSH で接続できます。

🛠 仕組み

広範な情報から詳細な情報へと段階的に掘り下げる、目的別の10個のツールを用意しています。エージェントは、質問に答えられる最も低コストなツールを選択します。

                                                           ┌─→ 📦 dig_package_overview ─┐
                                                           │   (docs, key types)        │
   🩺 dig_status  →  📋 dig_list  →  📖 dig_repo_overview  ┤                            ├─→  🔎 dig_lookup     →  📄 dig_file
   (health)          (discover)      (README + summaries)  │                            │   (symbol → file)       (full source)
                                                           ├─→ 📁 dig_package_files ────┤
                                                           │   (file listing)           │
                                                           └────────────────────────────┴─→  📝 dig_signatures
                                                                                            (stripped API)

   Operational:  🔄 dig_refresh   (force cache invalidation, on demand)
   Bootstrap:    🌱 dig_init      (only when no config exists)

🧰 ツール（10個）

dig_lookup の検索モード：

🚀 クイックスタート

インストール

npm install -g mcp-digger
# or run directly
npx mcp-digger

Node.js 20 以降、PATH 上の git、および .NET / C# ソースリポジトリ（.csproj と .cs ソースを含む NuGet パッケージ）が必要です。

最小限の設定

ワークスペースのルートに .digger/config.json を作成します：

{
  "repos": [
    {
      "name": "my-libraries",
      "url": "https://github.com/org/shared-libs.git",
      "packageFilter": "MyCompany.*",
      "auth": {
        "strategy": "pat",
        "PAT-EnvVarName": "GIT_PAT"
      }
    }
  ]
}

まだ設定ファイルがありませんか？サーバーを起動してから、dig_init を呼び出してひな形を作成してください。

エージェントの設定

{
  "mcpServers": {
    "digger": {
      "command": "npx",
      "args": ["-y", "mcp-digger"]
    }
  }
}

[mcp_servers.mcp-digger]
command = "npx"
args = ["-y", "mcp-digger"]

{
  "mcpServers": {
    "digger": {
      "command": "npx",
      "args": ["-y", "mcp-digger"]
    }
  }
}

{
  "servers": {
    "digger": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-digger"]
    }
  }
}

{
  "mcpServers": {
    "digger": {
      "command": "npx",
      "args": ["-y", "mcp-digger"]
    }
  }
}

確認

接続したら、エージェントに dig_status を呼び出すよう依頼してください。設定の検証、リポジトリごとの接続状況、インデックスの健全性が報告されます。

⚙ 設定

リポジトリとパッケージ

repos[] エントリでは、パッケージを次の3つの方法で指定できます：

sourceRoot のデフォルト値は "src" です。パッケージフォルダーがあるディレクトリを指定してください。再帰的に検索するため、src/Group/Foo/Foo.csproj のような入れ子になった構成も検出されます。

{
  "repos": [
    {
      "name": "my-libraries",
      "url": "https://github.com/org/shared-libs.git",
      "branch": "develop"
    }
  ]
}

{
  "localRepos": {
    "my-libraries": "C:/repos/shared-libs"
  },
  "repos": [
    {
      "name": "my-libraries",
      "sourceRoot": "src"
    }
  ]
}

🩺 診断と復旧

デバッグログ

設定でデバッグログを有効にします。

{ "debug": true, "repos": [...] }

ログは .digger/debug.log に出力されます（最大 5 MB で、自動的に切り詰められます）。重大なエラーとクラッシュ時の出力は .digger/error.log に記録されます。

💬 フィードバック

mcp-digger をご自身のコードベースで試しましたか？うまくいったこと、問題が発生したこと、不足している機能について、GitHub Discussions で共有してください。バグ報告は Issues にお寄せください。

📜 ライセンス

MIT License — LICENSE をご覧ください。