justrach/codedb

解决的问题

codedb 是一个上下文引擎，旨在帮助 AI 编码代理导航并理解大型代码库。它通过提供存储库的结构图来解决“幻觉”或上下文缺失的问题，使代理无需读取存储库中的每个文件即可找到定义、调用者和依赖项。

运作原理

codedb 使用 Zig 构建，索引本地文件系统并通过模型上下文协议 (MCP) 提供一系列工具。它使用混合检索系统，结合了三元组加速的全文本搜索、用于 O(1) 单词查找的倒排索引，以及可选的语义搜索（使用托管嵌入或本地 ANN 搜索）。它会建立包含符号、调用路径和依赖图的代码库结构图，并可通过 MCP 服务器、HTTP 服务器或 CLI 提供给代理使用。

适用对象

使用 AI 编码代理（如 Claude Code、Cursor、Windsurf、Devin 或 Copilot CLI）的开发人员，他们需要代理对项目的结构关系和源代码上下文有更深入、更精确的理解。

特色亮点

• MCP 集成：原生支持多种 MCP 客户端，允许代理使用如 codedb_explain 和 codedb_callpath 等工具。
• 高性能：与 ripgrep 或 grep 等传统工具相比，符号和全文本搜索的延迟极低。
• Token 效率：返回结构化、相关的结果而非原始行转储，显著减少 AI 代理的 Token 使用量。
• 广泛的语言支持：支持 Zig、C/C++、Python、TypeScript/JavaScript、Rust、Go、PHP、Ruby、HCL、R、Dart/Flutter 和 OCaml 的解析器。
• 多平台：提供 macOS、Linux 和 Windows 的原生二进制文件。