codebase-memory-mcp MCPサーバー

概要

codebase-memory-mcpは、DeusDataが開発したオープンソースのMCPサーバー（AIエージェントに新しい能力を追加するプラグイン）です。プロジェクトのソースコード全体を一度スキャンして「ナレッジグラフ（知識の地図）」に変換・保存します。AIエージェントはその地図を参照することで、ファイルを一つひとつ読むことなく、関数・クラス・呼び出し経路・HTTPルートといった構造情報をミリ秒以下で取得できるようになります。

AIがコードを読む際、従来のファイル全読み方式では大量のトークン（AIの処理コスト）が消費されます。公式ベンチマークによれば、同じ5つの構造的な問い合わせを行った場合、ファイル逐次読み込みが約412,000トークンを消費するのに対し、codebase-memory-mcpは約3,400トークンで済み、99.2%の削減を実現しています。31の実際のリポジトリで検証した結果、回答品質83%・トークン数10分の1・ツール呼び出し回数2.1分の1という成果が論文（arXiv:2603.27277）にまとめられており、設計の信頼性が裏付けられています。

主な機能

• 158言語対応のコード解析: Python・TypeScript・Go・Rust・Java・C++・Kotlin・PHPなど158種類のプログラミング言語をtree-sitter（コードを構文ツリーに変換する解析エンジン）で解析し、関数・クラス・呼び出し関係を永続的なナレッジグラフとして保存します。
• 高精度な型推論（Hybrid LSP）: Python・TypeScript/JavaScript・Go・Rust・Javaなど主要9言語ファミリーに対して、言語サーバーレベルの型解析を内蔵バイナリ単体で実施。外部サーバーや追加セットアップは不要です。
• 超高速クエリ（1ms以下）: ナレッジグラフへの問い合わせはサブミリ秒で完了。Linuxカーネル（2,800万行・75,000ファイル）でさえ3分でインデックス完成という極端な高速性を持ちます。
• ローカル完結・ゼロテレメトリー: 処理はすべて自分のPC上で行われ、コード・クエリ・環境情報は一切外部に送信されません。APIキー不要で、クラウドサービスへの依存もありません。
• クロスサービスリンク検出: HTTP・gRPC・GraphQL・tRPCなどのAPIエンドポイントをコードから自動検出し、サービス間のつながりもグラフのエッジ（辺）として記録します。マイクロサービス構成のプロジェクトでも全体像を把握できます。
• 増分インデックス（差分更新）: ファイルを変更した際は変更分だけを再解析するため、毎回フルスキャンする必要がなく、常に最新の状態を維持しながら効率よく動作します。
• 15種のMCPツールと3Dグラフ可視化UI: trace_path（呼び出し経路の追跡）・search_graph（グラフ検索）・manage_adr（設計上の意思決定記録の管理）など15種のMCPツールを提供。UIバリアントではブラウザ上（localhost:9749）で3Dグラフとしてナレッジグラフを視覚的に探索できます。

料金プラン

codebase-memory-mcp自体は完全無料のオープンソースソフトウェアです。ただし、実際にAIと会話する際に使用するClaudeやGeminiなどのAIエージェント側の利用料金は別途かかります（各サービスの料金体系に従います）。

導入方法

最も簡単な方法は npm または pip を使ったインストールです。

① npmを使う場合（Node.jsユーザー向け）

npm install -g codebase-memory-mcp
codebase-memory-mcp install

② pipを使う場合（Pythonユーザー向け）

pip install codebase-memory-mcp
# または
pipx install codebase-memory-mcp

codebase-memory-mcp install

③ インストール後の流れ

1. codebase-memory-mcp install を実行すると、Claude Code・Cursor・VS Code・Gemini CLIなどの対応エージェントを自動検出し、設定ファイルへの登録まで行います。
2. AIエージェントを再起動します。
3. AIに「このプロジェクトをインデックスして」と伝えるだけで、ナレッジグラフの構築が始まります。

④ macOS・Homebrewの場合

brew install DeusData/tap/codebase-memory-mcp
codebase-memory-mcp install

Windows（PowerShell）やScoop・Chocolateyなど他のパッケージマネージャーにも対応しています。詳細はGitHub公式READMEを参照してください。

こんな人におすすめ

• 大きなコードを引き継いだ・読み解きたい個人開発者: 複雑な既存コードの全体像を把握するのが苦手な場合、「この関数はどこで使われているの？」という疑問をAIに素早く答えてもらえます。ファイルを読み漁る無駄が激減します。
• Claude CodeやCursorなどAIコーディングツールをすでに使っている方: 現在使っているAIエージェントにそのままプラグインできます。別のAPIキーや追加サービス契約は不要で、今のAIがより賢くなるイメージです。
• AIのAPI利用コストを抑えたい方: トークン消費量が大幅に削減されるため、APIの従量課金コストを節約できます。大規模なコードを扱うほど効果が大きくなります。
• 複数のマイクロサービスや多言語プロジェクトを開発している方: HTTP・gRPC・GraphQLなどのAPI間の依存関係を自動検出・可視化できるため、複数のサービスが絡み合う複雑なシステムの把握に役立ちます。

よくある質問

Q. プログラミングの知識がなくても使えますか？ A. インストールはnpmまたはpipの1コマンドで完了し、設定もエージェントへの自動登録が行われます。ただし、Claude CodeやCursorなどのAIコーディングエージェントを事前に導入している必要があります。それらの基本的な使い方がわかっていれば、追加の専門知識は不要です。

Q. 自分のコードがクラウドに送られることはありませんか？ A. ありません。codebase-memory-mcpは100%ローカルで動作し、テレメトリー（使用状況の収集）も一切行いません。コード・クエリ・環境情報はすべて自分のPC内に留まります。

Q. 対応しているAIエージェント・エディターは何ですか？ A. Claude Code・Codex CLI・Gemini CLI・Cursor・Zed・VS Code・Aider・OpenCode・Kiroなど11種類のエージェントに対応しており、installコマンドが自動検出・設定します。

Q. インデックス（ナレッジグラフの構築）はどれくらい時間がかかりますか？ A. 一般的なリポジトリはミリ秒〜数秒でインデックス完了します。Linuxカーネル（2,800万行・75,000ファイル）でも約3分という高速性です。また、ファイル変更時は変更分だけを差分更新するため、日常的な開発での再スキャンは非常に短時間で完了します。