codebase-memory-mcp: MCP クライアント向けのローカルコード知識グラフ

deusdata-codebase-memory-mcp：MCP クライアント向けの構造解析バックエンド

codebase-memory-mcp は、リポジトリを永続的な知識グラフに索引化し、15 の MCP ツールとして公開する C 実装である。README はこれを LLM ではなく構造解析バックエンドと説明している。自然言語からグラフクエリへの変換は、Claude Code などの MCP クライアント内のモデルが担当する。構文解析にはバイナリに組み込まれた vendored tree-sitter グラマーを使い、158 言語をカバーする。また Python、TypeScript、JavaScript、JSX、TSX、PHP、C#、Go、C、C++、Java、Kotlin、Rust、Perl などに Hybrid LSP セマンティック型解決を適用する。グラフは関数、クラス、呼び出しチェーン、HTTP ルート、サービス間リンクを記録する。

deusdata-codebase-memory-mcp：索引化の速度と RAM 優先パイプライン

README の主要な性能主張は、Apple M3 Pro 上で Linux カーネル（2800 万行、7.5 万ファイル）の完全索引化が 3 分、481 万ノードと 772 万エッジを生成するというものだ。同じリポジトリの高速索引化は 1 分 12 秒で 188 万ノードを生成し、Django は約 6 秒で 4.9 万ノードと 19.6 万エッジを生成した。パイプラインは RAM 優先と説明されている。LZ4 圧縮、インメモリ SQLite、最後の 1 回のダンプ、索引化完了後のメモリ解放である。README はトークン効率も報告している。5 つの構造クエリで約 3400 トークン、ファイル単位の grep 探索で約 41.2 万トークン、99.2% の削減となる。これらの値は README 自身のベンチマーク表と引用された arXiv プレプリントに由来し、独立した再現方法はソースに記載されていない。

deusdata-codebase-memory-mcp：配布、インストール、共有デーモン

プロジェクトは macOS（arm64/amd64）、Linux（arm64/amd64）、Windows（amd64）向けの単一の静的バイナリとして提供され、実行時依存関係はない。install コマンドはインストール済みのコーディングエージェントを自動検出し、サポートされていれば MCP エントリ、永続的な指示、スキル、ライフサイクルフックを書き込む。アカウントごとに 1 つの調整デーモンを設定済みクライアント間で共有する。最初のデーモン対応セッションが起動し、各セッションが自分の作業を登録し、最後のセッションが停止する。すべてのアクティブな CBM プロセスは、完全に同じバージョン、実行ファイルビルド、調整 ABI、正規のキャッシュルートで動作しなければならない。競合するプロセスは作業を始める前に失敗し、キャッシュログディレクトリの daemon-conflicts.ndjson に競合を記録する。更新はすべてのプラットフォームでインストールスクリプトから実行され、実行中のバイナリ内からは実行されない。README は cbm が自発的にネットワークリクエストを行わないと述べている。

deusdata-codebase-memory-mcp：マルチエージェント設定とツールの階層

インストーラは 43 のクライアントサーフェスを設定する。37 は自動検出、6 は条件付きで、条件付きとはドキュメント化されたプラットフォームか既存の設定パスがターゲットのアクティブ状態を証明する場合にのみ書き込むことを意味する。カスタムエージェント形式がドキュメント化されているクライアントでは、1 つの正規契約から 3 つの定義を作成する。Scout（Tier 1）は迅速な暫定探索のための約 3 から 4 の狭い呼び出し、Verify（Tier 2、デフォルト）はタスク指向のグラフ証拠、Auditor（Tier 3）は範囲を限定し未解決の制限を明示する。README のマトリクスは Claude Code、Codex CLI、Gemini CLI、Zed、OpenCode、VS Code、Cursor などを扱い、どのフックをインストールするか保留するかを示している。また、インストールされるフックは fail-open でコンテキストのみであり、安定したコンテキスト生成ライフサイクルイベントを持たないクライアントには、セッションをまたいで契約を運ぶ永続ファイルが渡されると説明している。

deusdata-codebase-memory-mcp：チーム共有のグラフ成果物

索引化は .codebase-memory/graph.db.zst という単一の圧縮ファイルを生成し、これをリポジトリにコミットすればチームメイトは完全な再索引化を省略できる。これは zstd 圧縮された SQLite スナップショットで、インデックスを剥がし、VACUUM INTO で圧縮し、zstd 1.5.7 で圧縮する。典型的な圧縮比は 8 対 1 から 13 対 1 である。2 つの階層がある。best は zstd -9 とインデックス剥離と VACUUM INTO を使い、明示的な index_repository で書き込まれる。fast は zstd -3 を使い、低遅延の増分更新のために watcher が書き込む。チームメイトがローカル DB を持たず成果物がある状態で codebase-memory-mcp を実行すると、index_repository はまず成果物をインポートし、次に増分索引化を実行して完全な再索引化コストを避ける。README によると、初回エクスポート時に merge=ours の .gitattributes 行が自動生成され、並行編集がバイナリ成果物で衝突しない。成果物は任意である。

deusdata-codebase-memory-mcp：CLI モードとクエリツール

すべての MCP ツールはローカルのワンショットコマンドとして呼び出せる。codebase-memory-mcp cli <tool> で、フラグはそのツールの入力スキーマから生成され、cli <tool> --help で確認できる。CLI コマンドは調整デーモンを起動も接続もせず、常駐プロセスも残さない。データを変更するコマンドは OS ベースの共有プロジェクト単位ロックを使い、同じプロジェクトの競合する作業を直列化しつつ、無関係なプロジェクトは独立して進められる。進捗は stderr だけに書き込まれ、stdout はコマンド結果のために機械可読のまま残る。stderr がリダイレクトされた場合は --progress で進捗を強制し、--json で完全な MCP 結果エンベロープを返す。クエリツールには search_graph、trace_path、detect_changes、読み取り専用の openCypher サブセットを備えた query_graph、get_code_snippet、get_architecture、search_code、manage_adr、ingest_traces がある。サポートされる Cypher サブセットの外側は、空の結果を返すのではなく明確な unsupported エラーで失敗する。

deusdata-codebase-memory-mcp：プライバシー方針、診断、MIT ライセンス

README は、このツールが 100% ローカルで実行され、テレメトリを収集せず、コード、クエリ、環境、使用状況がマシンの外に出ないと述べている。そのため、メンテナ側で再現できない問題については、ユーザー自身がデータを取得する必要がある。最初のデーモン対応セッションの前に CBM_DIAGNOSTICS=1 を設定すると、デーモンは rss、committed、peak、page_faults、fd、queries を含む JSON を 5 秒ごとに 1 行書く trajectory.ndjson メモリトレンドファイルと snapshot.json を書き込む。プロジェクトは MIT ライセンスでリリースされ、使用、コピー、修正、マージ、公開、配布、再ライセンス、販売の権利を認め、ソフトウェアを保証なしで現状のまま提供する。ライセンス本文はセキュリティ体制、サポートの約束、本番環境への適合性については何も述べていない。README はリリースバイナリが署名、チェックサム検証、70 以上のアンチウイルスエンジンによるスキャンを受けていると主張している。

編集部の結論

README は codebase-memory-mcp を配布と運用に重点を置いたプロジェクトとして説明している。単一の静的バイナリ、43 のクライアントサーフェスを設定するインストーラ、共有の調整デーモン、リポジトリにコミットできるグラフ成果物である。性能値は README 自身のベンチマーク表に由来し、MIT ライセンスは本文に列挙された権利だけを認め、いかなる保証も提供しない。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes