codedb
为 AI 代理提供代码智能服务，基于 Zig 内核，原生支持 MCP，零依赖。
证据显示：工具集为只读，无编辑能力，符合最小权限；安装脚本自动注册MCP并写入配置，但未明确提示用户确认；数据流透明，文档说明遥测默认开启且收集聚合数据；敏感文件自动排除；依赖为零，但npm包下载二进制并校验SHA256；外部影响包括自动注册和遥测，但提供退出选项；支持版本回滚和快照；来源归属明确，但发布者未验证。扣分：用户确认不足，遥测默认开启。
证据显示：README与代码结构一致，架构描述清晰；依赖为零，但npm包依赖网络下载；失败消息未详细说明。扣分：失败消息不充分。
证据显示：面向AI代理，场景明确；能力边界清晰，无编辑功能；触发精确，工具命名明确；跨平台支持。扣分：无重大扣分。
证据显示：文档结构良好，安装说明详细；命名稳定但API可能变化；示例丰富；已知限制明确；BSD-3-Clause许可证；版本和变更日志不完整；维护责任明确。扣分：命名稳定性不足，版本变更日志不完整。
证据显示：输出结构化，节省token；边际价值高，提供独特功能；成本效益好，零依赖。扣分：无重大扣分。
证据显示：性能声明有基准数据，但未提供复现细节；跨来源验证有限；事实与推断未明确分离。扣分：可验证性不足。
- 遥测默认开启，需用户主动关闭。
- 安装脚本自动修改多个工具配置，需审查。
- 发布者身份未验证，需谨慎使用。
这个 Agent 能做什么，适合哪些场景？
codedb 是一个面向 AI 代理的代码智能服务器，以 Zig 实现，支持 MCP 协议，提供结构索引、三元组搜索、单词索引、依赖图、文件监听等能力。它通过 20 多个 MCP 工具和 HTTP API 为代理提供快速、上下文丰富的代码查询，但不具备编辑功能，编辑仍由客户端的原生工具负责。codedb 的独特性在于其索引性能：预索引查询可比 ripgrep 快 538 倍，且索引构建速度极快（5200 个文件冷启动仅需约 310 毫秒）。它支持多种编程语言，包括 Zig、C/C++、Python、TypeScript/JavaScript、Rust、Go 等，并提供本地优先的数据隐私保护。
codedb 通过索引项目代码并提供高效查询来为 AI 代理提供上下文。它启动时会解析代码库，构建结构大纲、三元组全文索引、逆置单词索引和依赖图，并持续监听文件变化以增量更新索引。它通过 MCP 协议（stdio）或 HTTP API（localhost:7719）暴露工具，如 codedb_tree（文件树）、codedb_outline（符号列表）、codedb_search（全文搜索）、codedb_word（O(1) 单词查找）、codedb_callers（调用者）、codedb_deps（依赖图）、codedb_context（任务合成器）等。代理可以调用这些工具来探索代码，而无需扫描文件系统，从而节省时间和 token。
- 开发者在 Claude Code 或 Cursor 中编码时，希望快速定位符号定义或调用者，codedb 提供秒级响应。
- AI 代理在大型代码库中执行重构任务，需要快速了解依赖关系，codedb 的依赖图工具可提供完整图。
- 在编辑器中搜索特定字符串（如
handleAuth）但避免全文件扫描，codedb 的三元组搜索加速查询。 - 需要理解项目结构时，codedb 的文件树和概览工具生成带符号计数的结构。
- 对大量项目进行快速索引，然后频繁查询（如 CI 或本地开发），codedb 预索引可最大限度减少延迟。
- 远程探索公共 GitHub 仓库时，通过 DeepWiki 集成的远程 MCP 工具（如 read_wiki_structure、ask_question）进行了解。
这个 Agent 有哪些优点和局限？
- 极高查询速度：预索引查询比 ripgrep 快 538 倍，延迟亚毫秒
- 零运行时依赖，单二进制，跨平台支持 macOS/Linux/Windows
- 内置敏感文件过滤（.env、凭据、密钥）和本地优先数据隐私
- 自动注册主流 AI 工具（Claude Code、Codex、Cursor 等）的 MCP 服务器
- 提供便携快照，实现 MCP 服务器即时启动
- Alpha 状态，API 可能变化，快照格式可能不兼容
- 仅支持本地主机绑定，无认证，不适合远程部署
- 某些语言仅支持轻量级大纲，不支持完整解析
- 不提供编辑功能，需要结合客户端原生编辑工具
- 遥测默认开启，需要显式禁用
如何安装或部署这个 Agent？
macOS/Linux 安装：
curl -fsSL https://codedb.codegraff.com/install.sh | bash这会在 Claude Code、Codex、Gemini CLI、Cursor、Windsurf 和 Devin 中自动注册 MCP 服务器。Windows 在 PowerShell 中运行：
irm https://raw.githubusercontent.com/justrach/codedb/v0.2.5838/install/install.ps1 | iex也可使用 npm 安装：npx -y codedeebee mcp 或 npm install -g codedeebee。需要网络下载二进制文件。
如何使用这个 Agent？
作为 MCP 服务器启动：
codedb mcp /path/to/your/project或作为 HTTP 服务器：
codedb serve /path/to/your/project然后通过 MCP 客户端或 HTTP 调用工具，例如：
curl localhost:7719/tree
curl localhost:7719/symbol?name=AgentRegistry
curl localhost:7719/search?q=handleAuth&max=10可使用 codedb --version 检查版本，通过 CODEDB_NO_TELEMETRY=1 或 --no-telemetry 禁用遥测。
这个 Agent 与同类方案有什么区别？
与 ast-grep、ripgrep、grep 相比，codedb 在预索引场景下速度显著更快，且提供结构解析、依赖图、MCP 协议等独特功能；与 ctags 相比，codedb 提供更多索引特性。