codebase-memory-mcpとは?
DeusDataのcodebase-memory-mcpは、同梱した163のtree-sitter文法でリポジトリを解析し、関数、クラス、ファイル、import、呼び出し、ルート、データフローからなるSQLiteの知識グラフを作り、セッションをまたいで~/.cache/codebase-memory-mcpに保持します。v0.12.0からは、MarkdownやPDFのドキュメント、アーキテクチャ決定記録、Dockerfile、Kubernetesマニフェスト、Helmチャート、Terraform、CIジョブもグラフに取り込みます。これによりエージェントは、Serviceからワークロードとイメージをたどり、コンテナが実行するプログラムまで追えます。Hybrid LSPのパスが、Python、TypeScript、Go、Java、Rustなど11の言語ファミリーについて型解決で呼び出しエッジを精緻化します。
サーバーは17のMCPツールを公開します。たとえばsearch_graph(バイナリに組み込んだ埋め込みモデルによる構造検索、BM25検索、意味検索)、trace_path、git差分の影響範囲を示すdetect_changes、読み取り専用でCypher風のquery_graphです。インストーラーはClaude Code、Codex、Gemini CLI、Cursor、OpenCodeなど46のクライアント連携を設定します。オプションのブラウザビューアCBM Lensはオープンベータです。
リポジトリは2026年2月に作成され、MITライセンスでC言語製、スター数は約48,500、フォーク数は約4,000です。最新リリースは2026年10月16日のv0.12.1です。11月10日までの1週間で、npmパッケージは約12,100回、PyPIパッケージは約2,100回ダウンロードされました。
codebase-memory-mcpのインストール方法
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bashcodebase-memory-mcpは使う価値があるか?
codebase-memory-mcpは、このカテゴリのどのコードグラフよりもシステムの広い範囲を扱います。CodeGraphやGitNexusがソースファイルで止まるのに対し、このツールはコードを、それをビルドしデプロイするDockerfile、Kubernetesオブジェクト、Helmチャート、Terraformモジュール、CIステップと結びつけます。そのためtrace_pathは「この関数を誰が呼ぶか」だけでなく「このサービスを何がデプロイするか」にも答えられます。この広さをMITで提供している点は、GitNexusの非商用ライセンスにはまねできません。
公表されている数字は大きいものの、出どころは開発者自身です。メンテナーによる2026年3月のarXivプレプリントは、31のリ ポジトリで、ファイルを1つずつ調べる方法に比べてトークン使用量が10分の1、ツール呼び出しが2.1分の1になったと報告しています。READMEは、Linuxカーネル(75Kファイル、28M行)の完全なインデックス作成がApple M3 Proで3分、Cypherクエリが1 ms未満だったとしています。独立した追試は見つかりませんでした。
プライバシーの既定設定は競合より優れています。READMEによれば、バイナリは自発的にネットワーク要求を行わず、更新の確認もせず、テレメトリも収集しません。一方、CodeGraphとCocoIndex Codeは無効にしない限り利用状況を送信します。意味検索はバイナリに組み込まれた埋め込みモデルで動き、OllamaもAPIキーも不要です。リリースにはSLSA Level 3の来歴情報、cosign署名、チェックサム、VirusTotalのスキャン結果が付きます。それでもMicrosoft Defenderは一部のビルドを検出しており、プロジェクトは誤検知として文書化しています。
インストールはツール一覧から想像するより重めです。クイックスタートはcurlからbashに流すスクリプトで、v0.12.0のバイナリは331から335 MBもあり、そのせいでv0.12.1までnpm、PyPI、Goのインストーラーが動きませんでした。インストーラーは既定でフックを追加します。Claude Codeでは、Grep、Glob、Bashに対する非ブロッキングのPreToolUseフックがグラフの文脈を差し込み、install --no-hooksで外せます。CBM_ALLOWED_ROOTを設定しない限り、index_repositoryはどのパスでも受け付けます。
本当の論点は成熟度です。未解決のissueは約487件あり、6月から開いたままのメモリリークの報告や3月からのCPU高負荷の報告も含まれます。v0.12.0だけで231件のプルリクエストがマージされました。チームでグラフを共有する成果物は任意ですが、READMEは、更新のたびにコミットしたあるチームの履歴が350コミットで約6 GBに膨らんだと警告しています。
真価を発揮する場面
サービスをKubernetesで運用する企業のプラットフォームエンジニア
共有ライブラリの変更がどのデプロイとイメージに及ぶかを把握する
index_repositoryでモノレポをインデックスし、エージェントにブランチでdetect_changesを、deployとrunのモードでtrace_pathを実行させます。Service、ワークロード、イメージ、Dockerfile、プログラムの順にたどりますが、解決できないテンプレート化されたHelmの値は省かれるので、抜けはcheck_index_coverageで確認します。
CIのテストスイートが遅いC/C++チーム
プルリクエストが影響しうるテストだけを実行する
実験的なSmart CIレイヤーは、静的な到達可能性とテストごとのカバレッジを組み合わせ、根拠が足りなければrun_allに戻ります。絞り込めるのは対応するハーネスを使うC/C++コードだけです。READMEの勧めどおり、まずはレポートのみのシャドーモードで始めます。
規制業種の企業で開発部門全体 にエージェントを広げるエンジニアリングマネージャー
ベンダー契約なしに、データをノートPCの外に出さず、全員にコードグラフの文脈を与える
MITライセンスで、テレメトリもホスト型サービスもないため、交渉するものはありません。管理対象の設定でCBM_ALLOWED_ROOTを設定してインデックス範囲を限定し、既定のフックを残すか--no-hooksでインストールするかを最初に決めます。
導入前に確認すること
- 導入
- install.shスクリプトをcurlで取得するか(Windowsではinstall.ps1)、npm、PyPI、Homebrew、AUR、Nix、go installを使います。Claude Code用のプラグインもあります。インストーラーはクライアントを検出し、MCP設定、skill、3つのエージェントプロファイル、フックを書き込みます。エージェントを再起動して「Index this project」と伝えます。auto_indexは既定で無効です。
- 連携
- ツールは17個です。index_repository、list_projects、delete_project、index_status、check_index_coverage、search_graph、trace_path、detect_changes、query_graph、get_graph_schema、compare_graphs、get_code_snippet、get_file_outline、get_architecture、search_code、manage_adr、ingest_traces。ソースコードを編集するツールはなく、書き込み先はインデックス、そのADR文書、そしてpersistence: trueを指定した場合のみリポ ジトリの.codebase-memoryフォルダ内のグラフスナップショットです。
- データとプライバシー
- インデックスとグラフは~/.cache/codebase-memory-mcpにローカル保存されます。READMEによれば、バイナリはテレメトリを送らず、求められていないネットワーク要求もしません。CBM Lensは起動したときだけ127.0.0.1で待ち受け、オプションのブラウザ用モデルはHugging Faceからダウンロードされます。セキュリティアドバイザリは公開されていません。
- 大規模利用時のコスト
- 無料で、かかるのはローカルのCPU、RAM、ディスクだけです。インデックス作成時のメモリはindex_max_rss_mbやCBM_MEM_BUDGET_MBで制限できます。節約効果は、質問ごとに読むファイルが減ることでモデルの請求額に表れます。
- 制限
- stdioのみで、ネイティブのHTTPトランスポートは未対応の機能要望です。長い同期インデックス呼び出しはクライアントの期限を超えることがあるため、大きなリポジトリでは非同期モードが必要です。Hybrid LSPの対象は11の言語ファミリーで、それ以外はテキストによる解決に頼ります。稼働中のすべてのプロセスは完全に同じビルドである必要があります。
良い点
- グラフがコード、ドキュメント、Docker、Kubernetes、Helm、Terraform、CIにまたがる
- MITライセンスで、バイナリからのテレメトリもネットワーク通信もない
- 17のツールで読み取り専用のCypherクエリと差分の影響範囲を提供
- SLSA Level 3の来歴情報付きの署名済みリリース
気になる点
- 未解決のissueが約487件あり、メモリやCPUの報告も含む
- インストーラーが既定でエージェントのツール呼び出しにフックを追加する
- バイナリが330 MB超で、クイックスタートはcurlからbash
- うたわれるトークン削減はメンテナー自身の研究による
おすすめの人
サービスやデプロイ設定をまたいで変更の影響をエージェントに追わせたいチームで、雇用主が受け入れられるライセンスで、何もマシンの外に出したくない場合。
codebase-memory-mcpの代替
codebase-memory-mcp:よくある質問
- codebase-memory-mcpは使う価値があるか?
- MITで動かせる中で最も守備範囲の広いコードグラフで、関数からHelmチャートまでを扱いテレメトリもありませんが、インストール時に入るフックと500件近い未解決issueを受け入れられることが条件です。 評価は5点満点中4.2点です。
- codebase-memory-mcpの料金は?
- 無料のオープンソース(MIT)です。ホスト型のプラン、アカウント、APIキーはありません。
- codebase-memory-mcpの欠点は?
- 未解決のissueが約487件あり、メモリやCPUの報告も含む; インストーラーが既定でエージェントのツール呼び出しにフックを追加する; バイナリが330 MB超で、クイックスタートはcurlからbash; うたわれるトークン削減はメンテナー自身の研究による.
- codebase-memory-mcpは誰に向いているか?
- サービスやデプロイ設定をまたいで変更の影響をエージェントに追わせたいチームで、雇用主が受け入れられるライセンスで、何もマシンの外に出したくない場合。
- チームや本番環境でcodebase-memory-mcpを使うと費用はいくらか?
- 無料で、かかるのはローカルのCPU、RAM、ディスクだけです。インデックス作成時のメモリはindex_max_rss_mbやCBM_MEM_BUDGET_MBで制限できます。節約効果は、質問ごとに読むファイルが減ることでモデルの請求額に表れます。
- codebase-memory-mcpは企業データを扱っても安全か?
- インデックスとグラフは~/.cache/codebase-memory-mcpにローカル保存されます。READMEによれば、バイナリはテレメトリを送らず、求められていないネットワーク要求もしません。CBM Lensは起動したときだけ127.0.0.1で待ち受け、オプションのブラウザ用モデルはHugging Faceからダウンロードされます。セキュリティアドバイザリは公開されていません。
- codebase-memory-mcpの代わりになるものは?
- 当サイトでレビューした中で最も近い代替はCodeGraph, GitNexus, code-review-graph, Serena 、 CocoIndex Codeです。
回答確認日:2026年11月11日