codebase-memory-mcp

Google Translate: Japanese English

yubele

フォロワー 0人

Last updated: 2026/06/18

読む時間: 01:03

コード

通報

埋め込み用コード

通報

Last updated: 2026/06/18

読む時間: 01:03

概要

Slide content

AI コーディングエージェント向けの高速・効率的なコードインテリジェンスエンジン。全インデックスをミリ秒単位で実行可能。Linuxカーネル規模でも短時間を謳う構造的クエリ・関係性の高速返答を目指す。

主な機能・特徴

Slide content

高速なインデックス作成とメモリ中心のパイプライン（LZ4圧縮、インメモリSQLite、パターンマッチング）
単一の静的バイナリで macOS/Linux/Windows 対応。Dockerや追加依存なし、インストールだけで完結
158 言語の tree-sitter 解析、Hybrid LSP による意味解決をサポート。知識グラフとして関数・クラス・呼び出し・HTTP ルーティング等を構築
11 のエージェント対応。設定・スキル・プリツールフックを自動設定
3D グラフ視覚化のUIがあり得る（ローカルホストのポート9749）
インフラとしてのコード（Dockerfile、Kubernetes マニフェスト、Kustomize オーバーレイ）もグラフノードとして扱える
14 の MCP ツール群（検索、トレース、アーキテクチャ分析、Cypher クエリ等）

アーキテクチャ・構成図

Slide content

@startuml
title codebase-memory-mcp アーキテクチャ概略

actor ユーザー
rectangle MCP {
  クライアント側CLI --> サーバー
  サーバー --> 知識グラフ(グラフDB)
  知識グラフ --> tree-sitter解析エンジン
  知識グラフ --> LSPセマンティック解決
  サーバー --> Router/API
  Router/API --> HTTP/GRPC/GraphQL サービス
}
rectangle インフラ {
  Dockerfile
  Kubernetes マニフェスト
  Kustomize オーバーレイ
}
rectangle UI {
  Graph Visualization UI -> http://localhost:9749
}
ユーザー --> MCP
MCP --> インフラ
@enduml

使い方・はじめ方

Slide content

ワンラインインストール（macOS/Linux）と UI 付きのバージョン、Windows 用の手順あり
最新リリースからダウンロード、展開・インストール、エージェント再起動
install コマンドは macOS の quarantine 属性の除去や署名を自動で実施
3D グラフ UI 使用時は http://localhost:9749 をブラウザで開く
MCP セッション開始時に自動インデックスを有効化。初回接続時に新規プロジェクトを索引化
アップデート通知とアンインストール時の挙動を確認

まとめ・活用シーン

Slide content

ローカル処理前提の高度なコード知識グラフ検索・分析
大規模リポジトリの構造分析、呼び出し関係のリファクタ検討
複数エージェント運用によるコラボ型開発支援
インデックス自動化・オートインデックスによる継続的知識更新
UI によるビジュアルな依存関係・アーキテクチャの把握

グラフ視覚化 UI

グラフ視覚化 UI はローカルホストのポート9749で閲覧可能
UI バリアントがある場合の起動方法と閲覧先を案内

オートインデックス機能

MCP セッション開始時に自動インデックスを有効化
初回接続時に新規プロジェクトを索引化
既に索引済みのプロジェクトはバックグラウンドのウォッチャーで変更検出を継続

アップデートとアンインストール

アップデートコマンドと起動時のアップデート通知
アンインストール時にエージェント設定・スキル・フックを削除
バイナリと SQLite データベースは残る場合がある

配布と運用

単一の静的バイナリ、SQLite バックエンド、キャッシュディレクトリに保存
自動同期・ファイル変更検知で再インデックス
Route ノードを基本的なグラフ要素として扱う
CLI モードの使用例あり

インストール手順とプラットフォーム

macOS/Linux: 自動ダウンロード + インストールスクリプト
Windows: PowerShell の setup-windows.ps1 実行
AUR などのパッケージ提供例あり

設定と運用の環境変数の例

CBM_CACHE_DIR: デフォルト ~/.cache/codebase-memory-mcp
CBM_DIAGNOSTICS: デフォルト false
CBM_DOWNLOAD_URL: 更新ダウンロード先の上書き
CBM_LOG_LEVEL: ログレベル設定
CBM_WORKERS: 並列インデックス作成ワーカー数の上書き

MCP Tools の概要

Indexing / Querying の各ツールと簡易説明
Graph データモデルの要素（ノードラベル、エッジタイプ、Qualified Names、OpenCypher の一部）
セキュリティ・信頼性を担保する仕組み（ローカル処理、署名・チェックサム・ウイルス検査）

グラフ・データモデル要素

ノードラベル、エッジタイプ、Qualified Names
OpenCypher のサポート例
影響分析・構造検索のための edge-type

セキュリティ方針

ローカル処理前提でコードを読み取り、エージェント設定ファイルに書き込み
リリース binaries は署名・チェックサム・70+ のウイルス検査を実施
全処理はローカルで完結、問題報告先は SECURITY.md 参照

言語サポートとベンチマーク状況

158 言語の tree-sitter 解析、Hybrid LSP セマンティック型解決
今後ベンチマーク予定の言語・ファイル形式一覧があり、現時点でサポートあり
Many languages / file formats listed as "Also supported (not yet benchmarked)" 形式の注記