codebase-synapse

🧠 Codebase Synapse

AI エージェントにコードベース全体の深い理解を与えます。

コードベースをローカルのナレッジグラフにインデックス化する MCP サーバーです。52 個の AI ツールを備え、セマンティック検索、呼び出しグラフのたどり、Git の履歴調査、影響範囲分析などを利用できます。

Claude Code · Cursor · Windsurf · Zed · あらゆる MCP クライアントに対応

問題

AI コーディングエージェント（Claude、Cursor など）は強力ですが、限られたコンテキストしか扱えません。開いたファイルや渡したファイルしか見ることができません。呼び出しチェーン、アーキテクチャパターン、影響範囲について尋ねても、推測するしかありません。

Codebase Synapse がこの問題を解決します。リポジトリ全体を SQLite に保存されるローカルのナレッジグラフにインデックス化し、構造分析に基づいた確かな回答を AI エージェントに提供します。幻覚ではありません。

仕組み

graph LR
    A["📁 Your Codebase"] -->|Tree-sitter| B["🧩 Parser"]
    B -->|Symbols & Edges| C["🕸️ Knowledge Graph"]
    C -->|SQLite| D["💾 Local DB"]
    D -->|52 MCP Tools| E["🤖 AI Agent"]
    
    style A fill:#1a1b26,stroke:#7aa2f7,color:#c0caf5
    style B fill:#1a1b26,stroke:#bb9af7,color:#c0caf5
    style C fill:#1a1b26,stroke:#9ece6a,color:#c0caf5
    style D fill:#1a1b26,stroke:#e0af68,color:#c0caf5
    style E fill:#1a1b26,stroke:#f7768e,color:#c0caf5

⚡ クイックスタート

1. プロジェクトをインデックス化する（Zoekt 形式の CLI）

codebase-synapse index /path/to/your/repo

インデックス作成は独立した CLI コマンドとして実行され、~/.codebase-synapse/codebase.db に書き込みます。初回のインデックス作成には時間がかかりますが、再実行時には変更されたファイルのみを再インデックス化します。MCP サーバーはインデックスを作成せず、事前に作成されたインデックスを読み取るだけです。

2. MCP サーバーを起動する

npx codebase-synapse

これだけです。Docker もデータベースの設定もクラウドも必要ありません。サーバーは stdio 経由で起動し、事前に作成されたインデックスを MCP クライアントに提供します。

クライアントを設定する

{
  "mcpServers": {
    "codebase-synapse": {
      "command": "npx",
      "args": ["-y", "codebase-synapse"]
    }
  }
}

{
  "mcpServers": {
    "codebase-synapse": {
      "command": "npx",
      "args": ["-y", "codebase-synapse"]
    }
  }
}

npx -y codebase-synapse

✨ できること

🔍 検索と探索

🕸️ ナレッジグラフ

🏗️ アーキテクチャ

🔬 Git の考古学

🧠 メモリとコンテキスト

🛡️ コードベースガード

ボーナスとして、codebase-guard は Claude Code 用の PreToolUse フックで、エージェントが最初に impact_analysis を実行するまで、影響の大きいファイルへの書き込みをブロックします。

ナレッジグラフの PageRank スコアと影響範囲データを使って、アーキテクチャ上のハブを特定します。コアファイルを誤って編集することはもうありません。

🔧 技術詳細

対応言語

Rust · Python · TypeScript · JavaScript · Go · Java · C# · PHP · C · C++

アーキテクチャ

src/
├── parser/       # Tree-sitter parsing & entity extraction
├── graph/        # Knowledge graph, PageRank, Leiden clustering
├── indexer/      # Repository indexing pipeline
├── search/       # BM25 full-text + vector cosine + hybrid RRF
├── embedding/    # Candle-based local embeddings (feature-gated)
├── memory/       # Persistent & session memory stores
├── mcp/          # MCP protocol transport + 52 tool handlers
├── git/          # Git archaeology, intent classification, hotspots
├── context/      # Budgeted context preparation for AI
├── cypher/       # Nom-based Cypher parser → SQL CTE planner
├── similarity/   # MinHash + LSH structural similarity
├── semantic/     # Multi-signal scoring (tokens, directory, AST)
└── cli/          # Interactive TUI installer + artifact export/import

🤝 貢献

貢献を歓迎します！このプロジェクトでは、標準的な Rust ツールを使用しています。

# Run tests
cargo test

# Lint
cargo clippy -- -D warnings

# Format
cargo fmt --all

📄 ライセンス

Apache-2.0