codedb
为 AI 代理提供代码智能服务，基于 Zig 内核，原生支持 MCP，零依赖。
- Star 数
- ★ 1.4k
- 最近更新
- 20 天前
- License
- BSD-3-Clause
- 主语言
- Zig
- FA 评分
- 60/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配ChatGPT · Codex · Claude Code · Claude.ai · OpenAI API · Claude API
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 开发者在 Claude Code 或 Cursor 中编码时，希望快速定位符号定义或调用者，codedb 提供秒级响应。
- 不适合
- 需要远程部署或多人共享服务的团队：仅绑定 localhost 且无认证
- 需要内置代码编辑能力的用户：codedb 没有编辑工具，必须配合客户端原生编辑
- 对遥测敏感且不愿手动关闭的团队：遥测默认开启
- 源码审查
- 60/100 · 存在缺口
这个 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？
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 有哪些优点和局限？
- 极高查询速度：预索引查询比 ripgrep 快 538 倍，延迟亚毫秒
- 零运行时依赖，单二进制，跨平台支持 macOS/Linux/Windows
- 内置敏感文件过滤（.env、凭据、密钥）和本地优先数据隐私
- 自动注册主流 AI 工具（Claude Code、Codex、Cursor 等）的 MCP 服务器
- 提供便携快照，实现 MCP 服务器即时启动
- Alpha 状态，API 可能变化，快照格式可能不兼容
- 仅支持本地主机绑定，无认证，不适合远程部署
- 某些语言仅支持轻量级大纲，不支持完整解析
- 不提供编辑功能，需要结合客户端原生编辑工具
- 遥测默认开启，需要显式禁用
这个 Agent 与同类方案有什么区别？
与 ast-grep、ripgrep、grep 相比，codedb 在预索引场景下速度显著更快，且提供结构解析、依赖图、MCP 协议等独特功能；与 ctags 相比，codedb 提供更多索引特性。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| codedb 当前 | 60 · 存在缺口 | MCP 服务器免费 | ★ 1.4k | 20 天前 | Zig | ChatGPT · Codex · Claude Code · Claude.ai · OpenAI API · Claude API |
| Empryo | 50 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.4k | 3 天前 | TypeScript | OpenAI API · Claude API |
| CodeSeek 代码智能 CLI | 48 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 768 | 2 个月前 | Rust | Codex · Claude Code |
| Devo 桌面编码智能体 | 58 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 338 | 3 天前 | Rust | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：工具集为只读，无编辑能力，符合最小权限；安装脚本自动注册MCP并写入配置，但未明确提示用户确认；数据流透明，文档说明遥测默认开启且收集聚合数据；敏感文件自动排除；依赖为零，但npm包下载二进制并校验SHA256；外部影响包括自动注册和遥测，但提供退出选项；支持版本回滚和快照；来源归属明确，但发布者未验证。扣分：用户确认不足，遥测默认开启。
证据显示：README与代码结构一致，架构描述清晰；依赖为零，但npm包依赖网络下载；失败消息未详细说明。扣分：失败消息不充分。
证据显示：面向AI代理，场景明确；能力边界清晰，无编辑功能；触发精确，工具命名明确；跨平台支持。扣分：无重大扣分。
证据显示：文档结构良好，安装说明详细；命名稳定但API可能变化；示例丰富；已知限制明确；BSD-3-Clause许可证；版本和变更日志不完整；维护责任明确。扣分：命名稳定性不足，版本变更日志不完整。
证据显示：输出结构化，节省token；边际价值高，提供独特功能；成本效益好，零依赖。扣分：无重大扣分。
证据显示：性能声明有基准数据，但未提供复现细节；跨来源验证有限；事实与推断未明确分离。扣分：可验证性不足。
- 遥测默认开启，需用户主动关闭。
- 安装脚本自动修改多个工具配置，需审查。
- 发布者身份未验证，需谨慎使用。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v0.2.5860 CodeDB v0.2.5860
发布说明摘录
Faster hosted semantic index builds codedb semantic-index now sends 100-item batches with eight requests in flight by default. CODEDB_SEMANTIC_INDEX_CONCURRENCY still overrides the concurrency (1-8). Index builds wait out hosted rate limits with a doubling backoff capped at 30 seconds instead of failing after a few quick retries. Interactive codedb context calls are unchanged and still fall back to local results immediately. Local retrieval, the watcher, and the installer are unchanged.在 GitHub 查看 ↗ -
v0.2.5859 CodeDB v0.2.5859
发布说明摘录
Hosted semantic retrieval Fixes codedb context reporting semantic lane: unavailable with the default hosted configuration. The hosted default model id is now codedb-hosted-v1. Local ANN sidecars built by earlier releases are rebuilt once in the background; the bounded exact rerank serves requests meanwhile. Custom endpoints and explicit model overrides are unchanged. Local retrieval, the watcher, and the installer are unchanged.在 GitHub 查看 ↗ -
v0.2.5857 CodeDB v0.2.5857
发布说明摘录
More MCP clients The installer now registers codedb in every detected MCP client, not only Claude Code, Codex, Gemini CLI, Cursor, Windsurf, and Devin. New when the client is already present: oh-my-pi, Hermes, Qwen Code, ZCode, Trae, Cline, Copilot CLI, Antigravity, Kiro, and OpenCode. Malformed JSON is left untouched. codedb nuke removes the same entries. Antigravity writes only ~/.gemini/antigravity/mcp_config.json, not Gemini CLI settings. Nuke still clears the stray Gemini path and the non-CN Trae User/mcp.json path. Retrieval, the watcher, and hosted embeddings are unchanged. …在 GitHub 查看 ↗