Codedb 是一个为 AI 代理设计的高性能代码智能服务器，采用 Zig 语言构建。它提供结构化索引、三元组和单词搜索、依赖图分析以及文件监控，零外部依赖，通过 MCP 或 HTTP 接口实现亚毫秒级查询延迟。

codedb 是开源的吗？

是的，采用 BSD-3-Clause 许可证。

codedb

活跃·★ 1.4k·BSD-3-Clause·更新于 2026-10-26

★ 必备神器★ 时下流行

codedb 是面向 AI 代理的代码智能服务器，用 Zig 编写，以原生二进制发布。它为项目建索引，并提供 21 个 MCP 工具：带符号数量的文件树、函数/结构体/导入的结构大纲、符号查找、三元组加速的全文搜索、精确的单词索引、反向依赖图，以及带版本跟踪的原子化行范围编辑。文件监听器保持索引新鲜，快照加快 MCP 启动。

README 对状态很坦率：它称 codedb 是 alpha 软件，API 正在稳定但可能变化，快照格式可能在版本间改变，HTTP 服务器没有认证、只绑定本机。完整解析支持 Zig、C/C++、Python、TypeScript/JavaScript、Rust、Go、PHP、Ruby、HCL、R 和 Dart，Java、Kotlin、Vue、SQL 等语言只有较轻量的大纲支持。它会屏蔽 `.env` 和凭据等敏感文件，macOS 二进制经过代码签名和公证。

用 `curl -fsSL https://codedb.codegraff.com/install.sh | bash` 安装，它会下载二进制并把它注册为 Claude Code、Codex、Gemini CLI 和 Cursor 里的 MCP 服务器；也可以通过 npm 以 `npx -y codedeebee mcp` 运行。还有 HTTP 模式（`codedb serve`）以及 `codedb search`、`codedb outline` 等命令行。README 宣称在预建索引的查询上比 ripgrep 快 538 倍，这是项目自己的基准。许可为 BSD-3-Clause，最近一次推送是 2026-10-03。本评测依据 README 和仓库数据，我们没有实际运行过它。

#代码智能#AI代理#结构化索引#三元组搜索#依赖图#文件监控#MCP协议#Zig语言

功能特性

01结构化索引与大纲：解析并索引代码，为多种语言提供结构化大纲（函数、结构体、导入）。

02超快速搜索：采用三元组搜索进行全文查询，并使用O(1)倒排词索引进行标识符查找，性能优于ripgrep等传统工具。

03依赖图与版本追踪：构建反向依赖图，并追踪带有版本控制的原子行范围编辑，以进行代码演进分析。

04模型上下文协议（MCP）与HTTP API：通过基于JSON-RPC 2.0的高性能MCP服务器或标准HTTP API提供代码智能。

05零依赖与跨平台：完全用Zig语言构建，无外部依赖，编译成单一二进制文件，支持macOS（ARM/x86）和Linux（ARM/x86）。

为什么选择它

+21 个 MCP 工具：大纲、符号和全文搜索、单词索引、反向依赖图和原子化行编辑

+自动注册为 Claude Code、Codex、Gemini CLI 和 Cursor 里的 MCP 服务器

+屏蔽 `.env` 和凭据等敏感文件，HTTP 服务器只绑定本机

+状态说明很坦率；macOS 二进制已签名和公证，安装器会校验 SHA256；BSD-3-Clause

权衡点

!README 自称 alpha：API 和快照格式在版本间可能变化

!完整解析只覆盖有限的语言，Java、Kotlin、SQL 等只有轻量大纲

!比 ripgrep 快 538 倍是项目自己在预建索引查询上的基准

!默认安装把脚本直接交给 bash 执行，Linux 二进制没有签名

维护状况检查

活跃检查日期: 2026-10-23

最近提交: 2026-09-29
近 90 天提交数: 100+
近 90 天发布数: 27
最新发布: v0.2.5860 (2026-09-27)
未关闭 issue: 13
近期 issue 至少有一条评论的比例: 8/8

近 12 周每周提交数

最早的一周在左边，最近 4 周为橙色。数据来源：GitHub 提交统计。

状态规则：GitHub 上已归档 = 已归档；最近提交在 90 天内 = 活跃；91 到 365 天 = 放缓；更久 = 停滞。所有数字来自所示日期的 GitHub API。

讨论最多的未关闭 issue

#756 macOS: watcher burns ~60% of a core per MCP client on a 16k-file root with no worktrees (overflow re-hash + unconditional 2 s full-tree audi4 条评论 · 2026-09-20
#767 repo size: ~208 MB of .zig-cache-local build artifacts are still in git history (GitHub reports ~90 MB)3 条评论 · 2026-10-03
#766 index: SIGSEGV on worker thread during cold index of a non-git root; codedb.snapshot is also not excluded from the walk3 条评论 · 2026-10-01

issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。

兼容性

Zig

核心语言

已通过文档验证

macOS

平台

已通过文档验证

Linux

平台

已通过文档验证

Python

解析器

已通过文档验证

TypeScript/JavaScript

解析器

已通过文档验证

Rust

解析器

已通过文档验证

快速开始

$ curl -fsSL https://codedb.codegraff.com/install.sh | bash

使用场景

↳赋能AI代理：与Claude、Codex、Gemini和Cursor等AI代理无缝集成，为它们提供深入的代码理解能力。

↳高性能代码库探索：在大规模项目中实现快速导航、符号查找和结构化分析。

↳远程代码智能：无需本地克隆即可查询公共GitHub仓库，通过`codedb_remote`工具访问代码智能。

↳自动化代码分析工作流：利用CLI或API执行自动化任务，如查找最近修改的文件、检查符号定义或执行正则表达式搜索。

↳开发者工具与集成：作为需要深度代码上下文的自定义开发者工具或IDE集成的快速后端。

codedb

活跃·★ 1.4k·BSD-3-Clause·更新于 2026-10-26

★ 必备神器★ 时下流行

#代码智能#AI代理#结构化索引#三元组搜索#依赖图#文件监控#MCP协议#Zig语言

功能特性

01结构化索引与大纲：解析并索引代码，为多种语言提供结构化大纲（函数、结构体、导入）。

02超快速搜索：采用三元组搜索进行全文查询，并使用O(1)倒排词索引进行标识符查找，性能优于ripgrep等传统工具。

03依赖图与版本追踪：构建反向依赖图，并追踪带有版本控制的原子行范围编辑，以进行代码演进分析。

04模型上下文协议（MCP）与HTTP API：通过基于JSON-RPC 2.0的高性能MCP服务器或标准HTTP API提供代码智能。

05零依赖与跨平台：完全用Zig语言构建，无外部依赖，编译成单一二进制文件，支持macOS（ARM/x86）和Linux（ARM/x86）。

为什么选择它

+21 个 MCP 工具：大纲、符号和全文搜索、单词索引、反向依赖图和原子化行编辑

+自动注册为 Claude Code、Codex、Gemini CLI 和 Cursor 里的 MCP 服务器

+屏蔽 `.env` 和凭据等敏感文件，HTTP 服务器只绑定本机

+状态说明很坦率；macOS 二进制已签名和公证，安装器会校验 SHA256；BSD-3-Clause

权衡点

!README 自称 alpha：API 和快照格式在版本间可能变化

!完整解析只覆盖有限的语言，Java、Kotlin、SQL 等只有轻量大纲

!比 ripgrep 快 538 倍是项目自己在预建索引查询上的基准

!默认安装把脚本直接交给 bash 执行，Linux 二进制没有签名

维护状况检查

活跃检查日期: 2026-10-23

最近提交: 2026-09-29
近 90 天提交数: 100+
近 90 天发布数: 27
最新发布: v0.2.5860 (2026-09-27)
未关闭 issue: 13
近期 issue 至少有一条评论的比例: 8/8

近 12 周每周提交数

最早的一周在左边，最近 4 周为橙色。数据来源：GitHub 提交统计。

状态规则：GitHub 上已归档 = 已归档；最近提交在 90 天内 = 活跃；91 到 365 天 = 放缓；更久 = 停滞。所有数字来自所示日期的 GitHub API。

讨论最多的未关闭 issue

#756 macOS: watcher burns ~60% of a core per MCP client on a 16k-file root with no worktrees (overflow re-hash + unconditional 2 s full-tree audi4 条评论 · 2026-09-20
#767 repo size: ~208 MB of .zig-cache-local build artifacts are still in git history (GitHub reports ~90 MB)3 条评论 · 2026-10-03
#766 index: SIGSEGV on worker thread during cold index of a non-git root; codedb.snapshot is also not excluded from the walk3 条评论 · 2026-10-01

issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。

兼容性

Zig

核心语言

已通过文档验证

macOS

平台

已通过文档验证

Linux

平台

已通过文档验证

Python

解析器

已通过文档验证

TypeScript/JavaScript

解析器

已通过文档验证

Rust

解析器

已通过文档验证

快速开始

$ curl -fsSL https://codedb.codegraff.com/install.sh | bash

使用场景

↳赋能AI代理：与Claude、Codex、Gemini和Cursor等AI代理无缝集成，为它们提供深入的代码理解能力。

↳高性能代码库探索：在大规模项目中实现快速导航、符号查找和结构化分析。

↳远程代码智能：无需本地克隆即可查询公共GitHub仓库，通过`codedb_remote`工具访问代码智能。

↳自动化代码分析工作流：利用CLI或API执行自动化任务，如查找最近修改的文件、检查符号定义或执行正则表达式搜索。

↳开发者工具与集成：作为需要深度代码上下文的自定义开发者工具或IDE集成的快速后端。

codedb

功能特性

为什么选择它

权衡点

维护状况检查

讨论最多的未关闭 issue

兼容性

快速开始

使用场景

同类工具

评论

codedb

功能特性

为什么选择它

权衡点

维护状况检查

讨论最多的未关闭 issue

兼容性

快速开始

使用场景

同类工具

评论