CodeGraph

給 AI Agent 用的程式碼結構索引。

Claude Code、Cursor 這類 agent 要找一個函數，常常得打開好幾個上千行的檔案， 一次吞掉大量 token。CodeGraph 先用 tree-sitter 把整個專案解析成符號與關係， 存進本機的 SQLite；agent 透過 MCP 問一次，就拿到相關符號的逐字原始碼、 它們之間的呼叫路徑，以及改動會波及的範圍——不必自己一個一個檔案讀。

索引留在專案裡的 .codegraph/，不上傳任何東西。

安裝

從 Releases 下載對應平台的壓縮檔， 解開後把 codegraph（Windows 是 codegraph.exe）放進 PATH。

每個 Release 都附 SHA256SUMS，下載後可以驗證：

sha256sum -c SHA256SUMS --ignore-missing

或從原始碼建置（需要 Rust 1.88 以上與 C 編譯器）：

cargo install --git https://github.com/chainchen1103/codegraph-mcp --locked

Related MCP server: Symbol Delta Ledger

快速開始

cd your-project
codegraph init        # 建立 .codegraph/，不會開始索引
codegraph index       # 全量索引
codegraph explore "Store::open"

explore 接受符號名、限定名（Type::method）、檔案路徑，或自然語言問句。 指名兩個以上的符號時，會先印出它們之間的呼叫路徑。

之後改了程式碼，用增量同步更新，只重新解析變過的檔案：

codegraph sync          # 同步一次
codegraph sync --watch  # 常駐監看，存檔就更新

接上 Claude Code / Cursor

codegraph serve --print-config

會印出一段設定，貼進 MCP 設定檔：Claude Code 是專案根目錄的 .mcp.json， Cursor 是 .cursor/mcp.json。重啟之後 agent 就看得到三個工具：

工具刻意只有三個。實測 agent 只會可靠地呼叫一個工具，新能力的做法是讓 explore 的答案更完整，而不是再開一個工具。

當前目錄沒有索引時工具照樣存在，回應會說明下一步，而不是回錯誤—— monorepo 只有部分子專案建了索引是常見情況，可以用 projectPath 參數指向 任何一個已索引的目錄。工具不會自行建立索引，那是使用者的決定。

支援的語言

同一個 repo 裡混用多個語言沒有問題，各語言的符號與關係不會互相串接。

指令一覽

PATH 省略時從工作目錄往上找 .codegraph/，遇到 repo 邊界（.git）就停。

現況

早期版本。索引格式還在演進，升級後若 status 或查詢回報 schema 版本不相容， 刪掉 .codegraph/ 重新 codegraph index 即可——索引隨時可以從原始碼重建。

規劃中但尚未提供的：C / C++ / CUDA 等更多語言、CI 上預先建好索引供開發端下載、 PR 審查時列出 git diff 看不見的受影響呼叫端。