Codebase Context MCP

🚀 codebase-context-mcp

コードベースのインデックス作成と検索を行うMCPサーバーで、Raspberry PiやApple SiliconのようなARM64デバイスを含むあらゆるプラットフォームで動作します。これらのARM64デバイスでは、他の多くの代替手段が機能しません。

🚀 クイックスタート

このコードベースのインデックス作成と検索用のMCPサーバーは、ARM64デバイスを含むあらゆるプラットフォームで動作します。これにより、x86_64用にのみ事前にビルドされたバイナリが用意されている一般的なコードベースインデックス作成MCPサーバーの問題を解決します。

✨ 主な機能

• すべてのネイティブ依存関係をWASM相当物で置き換え、どんなアーキテクチャでもnpm installが初めての試行で成功します。
• ドロップイン互換性があり、標準のMCP stdioトランスポートを介して同じコアツール（インデックス、検索、アウトライン、要約）を提供します。

📦 インストール

Claude Code（推奨）

claude mcp add codebase-context -s user -- npx codebase-context-mcp

または、ローカルクローンから:

git clone https://github.com/Jhackman2019/codebase-context-mcp.git
cd codebase-context-mcp
npm install && npm run build
claude mcp add codebase-context -s user -- node /path/to/codebase-context-mcp/dist/index.js

MCP設定（JSON）

{
  "mcpServers": {
    "codebase-context": {
      "command": "npx",
      "args": ["codebase-context-mcp"]
    }
  }
}

💻 使用例

基本的な使用法

以下のコマンドでインストールし、サーバーを起動できます。

npm install
npm start

高度な使用法

開発中には、以下のコマンドを使用してコードの変更を監視できます。

npm run dev

📚 ドキュメント

ツール

サポートされる言語

TypeScript、TSX、JavaScript、Python、C#、VB.NET、XML、CSS、JSON

動作原理

• 解析: web-tree-sitter (WASM) — ネイティブのtree-sitterと同じAST品質で、どんなアーキテクチャでも動作します。
• 検索: BM25テキストランキング (純粋なJS) + シンボル名のマッチング
• ストレージ: ~/.codebase-context-mcp/<project-hash>.jsonにJSONファイルインデックスを保存します。
• トランスポート: @modelcontextprotocol/sdkを介したMCP stdio
• インクリメンタル: コンテンツハッシュが変更されていないファイルは、再インデックス時にスキップされます。

セーフティ制限

開発

npm install
npm run build    # tsupでビルド
npm run dev      # ウォッチモード
npm start        # サーバーを起動

📄 ライセンス

MIT