justrach/codedb

Zig code intelligence server and MCP toolset for AI agents. Fast tree, outline, symbol, search, read, edit, deps, snapshot, and remote GitHub repo queries.

解決的問題

codedb 是專為 AI Agent 設計的程式碼智能伺服器。它透過提供高性能的上下文引擎，對程式碼進行結構化與文本化索引，而不是僅僅依賴原始檔案讀取或暴力搜尋，從而解決了 Agent 在高效查找與理解大型程式碼庫時遇到的難題。

工作原理

codedb 使用 Zig 編寫，零外部依賴，在啟動時會建立專案的全面索引。它結合使用了結構化解析（用於函數、結構體與匯入）、用於加速全文搜尋的 trigram 索引，以及用於 O(1) 識別碼查找的反向詞索引。輪詢檔案觀察器即時保持索引更新。它透過 Model Context Protocol (MCP) 與 HTTP 伺服器公開這些智能資訊，允許 AI Agent 在無需重新掃描檔案系統的情況下查詢符號、依賴關係與輪廓。

適用對象

使用 AI Agent（如 Claude Code、Cursor、Windsurf 或 Devin）的開發者，他們需要 Agent 能夠對程式碼庫結構與符號進行深度、低延遲的存取，以提高準確性並減少 Token 消耗。

亮點

  • 極致性能：預索引查詢比 ripgrep 或 grep 等工具快幾個數量級。
  • 原生支援 MCP：提供 21 個專門的工具供 Agent 探索程式碼，包括依賴關係圖與符號查找。
  • Token 高效：回傳結構化、相關的結果，而不是原始行轉儲，顯著減少了每個查詢使用的 Token 數量。
  • 廣泛的語言支援：全面支援 Zig, C/C++, Python, TypeScript/JavaScript, Rust, Go, PHP, Ruby, HCL, R 與 Dart 的解析器。
  • 雲端智能：codedb_remote 工具允許 Agent 透過 api.wiki.codes 查詢已索引的公開 GitHub 儲存庫，無需本地複製。