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 仓库，无需本地克隆。