DeusData/codebase-memory-mcp
High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.
codebase-memory-mcp – AIコーディングエージェント向けの高速でローカルのコードインテリジェンスエンジン
何であるか – Tree-sitterパーサーを用いて158言語に対応する、永続的な知識グラフを構築するネイティブでランタイム不要の実行可能ファイル。関数、クラス、呼び出しチェーン、HTTPルート、インフラファイルなど、コードベースの構造を高速にインデックス化。ミリ秒単位でクエリ可能で、AI駆動のコーディングアシスタント（Claude Code、Codex、OpenCodeなど）が、ソースファイルをクラウドに送信せずに構造的質問に即座に答えるためのデータとして利用される。
なぜ重要か – 伝統的なLLMベースのコードツールはファイルを1つずつスキャンするため、遅く、トークン消費が激しい。このツールはリポジトリを一度インデックス化し、グラフを公開することで、トークン予算を約120倍削減し、ツールコールのオーバーヘッドを2倍以上削減。また、「この関数はどこで使われているか？」や「この変更の影響は何か？」といった複雑な質問も1ミリ秒未満で回答可能。
コア機能
| 機能 | 機能内容 |
|---|---|
| 超高速インデックス化 | Linuxカーネル（28M LOC、75kファイル）を約3分でインデックス化。通常のリポジトリは数秒で処理可能。 |
| ハイブリッドLSP型型解決 | Python、TS/JS、PHP、C#、Go、C/C++、Java、Kotlin、Rust、Perlなど12言語について、軽量なC実装で人気の言語サーバーを模倣する深層意味解析を実施。 |
| グラフ＆分析API | 関数、クラス、インポート、呼び出しエッジ、HTTPルート、gRPC/GraphQLサービス、イベントチャネルエッジ、未使用コード検出、コミュニティ検出（Louvain）、git差分用インパクトマッピング、ADR管理など。 |
| クエリ言語 | • Cypher風：グラフ上のパターンマッチング • 意味的検索：Nomicコード埋め込み（APIキー不要） • BM25全文検索：SQLite FTS5とcamelCase/snake_case対応トークナイザー • 構造的/正規表現検索：ノードラベルに対して |
| 組み込み3D UI | ローカルWeb UI（localhost:9749）を起動し、1つまたは複数のリポジトリにまたがるグラフを可視化。 |
| リポジトリ間インテリジェンス | インデックス化された複数リポジトリのノードがリンク可能。ファルム全体のアーキテクチャビューを実現。 |
| ゼロランタイム、ローカル専用 | Dockerも言語ランタイムも外部APIキーも不要。すべての処理は開発者のマシン上で完結。 |
| エージェント統合 | Claude Code、Codex、OpenCodeなど43種類のサポートエージェントを自動検出し、設定ファイルに必要なMCPエントリを自動書き込み。 |
| パッケージマネージャー配布 | npm、PyPI、Homebrew、Scoop、Winget、AUR、go installで利用可能。 |
一般的なワークフロー
- インストール – macOS/Linuxでは
curl … | bash、WindowsではPowerShellスクリプトで、検証済みバイナリと小さなヘルパーをダウンロード。 - インデックス化 – インストール後、ツールは自動的にコーディングエージェントを検出。エージェントに「このプロジェクトをインデックス化」と指示。デーモンがグラフを構築し、
~/.cache/codebase-memory-mcp/に保存。 - クエリ – エージェントまたはCLIから
search_graph、detect_changes、カスタムCypherクエリなどを実行。エージェントは構造的質問に即座に応答可能。 - 可視化 –
codebase-memory-mcp --ui=true --port=9749を実行してブラウザでグラフを探索。 - 更新／アンインストール – 同じインストールスクリプトでアップグレード可能。
codebase-memory-mcp uninstallで設定エントリとオプションのインデックスをクリーンアップ。
どの人向けか
- LLMベースのコーディングアシスタントに依存し、自分のコードに関する決定論的で低遅延な回答を求める開発者。
- コードベースの共有でバージョン管理可能な表現が必要なチーム（
.codebase-memory/graph.db.zstアーティファクトをコミットすることで再インデックス化を回避可能）。 - コードグラフベースのプロンプティングやLLM向けツールコール戦略を研究する研究者。
制限事項と考慮点
- ローカル専用 – クラウドサービスなし。グラフが必要な各マシンでバイナリを実行する必要がある。
- 初期インデックスコスト – 最初のフルインデックスはメモリを大量に消費（インメモリSQLite、LZ4圧縮）するが、処理終了後にメモリを解放。
- 誤検出のウイルス対策アラート – Microsoft Defenderなど一部のスキャナーがバイナリを警告する場合あり。プロジェクトはハッシュとVirusTotalスキャンを提供し、整合性を検証可能。
- サポート言語 – 158の文法がバンドルされているが、深層意味的型解決（ハイブリッドLSP）は上記12言語に限定。
- エージェント互換性 – 43種類のエージェントは即時対応。他のツールは手動でのMCPエントリ設定が必要。
クイックスタートスニペット
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
# Windows (PowerShell)
Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1
notepad install.ps1 # オプションの確認
Unblock-File .\install.ps1
.\install.ps1
インストール後、コーディングアシスタントを再起動し、「このプロジェクトをインデックス化」とコマンドを発行。
詳細情報の入手先
- 研究論文 – Codebase-Memory: Tree-Sitter-Based Knowledge Graphs for LLM Code Exploration via MCP (arXiv:2603.27277)。
- ドキュメント – リポジトリの
README、SECURITY.md、およびリポジトリ内のUIスクリーンショットが、グラフスキーマとデーモン連携の詳細を提供。 - リリース – 各リリースには、同一の3つのバイナリ（未ストリップ、デバッグストリップ、ストリップ）が含まれ、VirusTotalスキャン済みでSHA-256ハッシュで署名済み。
結論 – codebase-memory-mcpは自己完結型で高性能なコードグラフエンジンを提供し、AIコーディングエージェントがコードベースをローカルで扱えるようにし、トークン使用量と遅延を劇的に削減しながら、すべてを自分の制御下に保つ。
関連
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト
- プロジェクト