codedb

面向 AI Agent 的代码智能服务器。核心基于 Zig 编写。原生支持 MCP。零依赖。

结构化索引 · Trigram 搜索 · 单词索引 · 依赖图 · 文件监听 · MCP + HTTP

状态 · 安装 · 快速开始 · MCP 工具 · 基准测试 · 架构 · 数据与隐私 · 构建

---

状态

Alpha 软件 — API 正在趋于稳定，但未来仍可能发生变动

codedb 目前已在生产环境的 AI 工作流中投入使用，但请注意：

• 解析器支持 — Zig, C/C++, Python, TypeScript/JavaScript, Rust, Go, PHP, Ruby, HCL, R, Dart/Flutter
• 轻量级大纲支持 — Java, Kotlin, Svelte, Vue, Astro, shell, CSS/SCSS, SQL, protobuf, Fortran, LLVM IR, MLIR 以及 TableGen
• 无认证 — HTTP 服务器仅绑定至 localhost
• 快照格式 可能在不同版本间发生变化
• MCP 协议 为基于 stdio 的 JSON-RPC 2.0（已稳定）

当前功能	开发中功能
21 个用于完整代码库智能化的 MCP 工具	更深层的解析器覆盖和边界情况处理
Trigram v2：整数文档 ID，批处理累积，合并交集	基于段的增量索引
在预索引查询中比 ripgrep 快 538 倍	适用于 Cloudflare Workers 的 WASM 目标
用于标识符查找的 O(1) 倒排单词索引	多项目支持
结构化大纲（函数、结构体、导入）	基于 mmap 的 trigram 索引
反向依赖图
带有版本追踪的原子行范围编辑
在 Claude, Codex, Gemini, Cursor 中的自动注册
带有过滤目录遍历器的轮询式文件监听器
用于实现即时 MCP 启动的可移植快照
带有 PID 锁 + 1小时空闲超时的单例 MCP
敏感文件屏蔽 (.env, 凭据, 密钥)
已签名 macOS ARM64 二进制文件；Intel 切片暂未签名
安装程序中的 SHA256 校验和验证
跨平台：macOS (ARM/x86), Linux (ARM/x86)

---

⚡ 安装

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

该脚本将下载适用于您平台的二进制文件，并自动将 codedb 注册为 Claude Code, Codex, Gemini CLI 和 Cursor 中的 MCP 服务器。安装程序会打印出已注册的 codedb mcp 命令，以及针对 Codex 和 Claude Code 的钩子（hook）设置指南。

或通过 npm/npx 安装（MCP 客户端无需预安装）

npx -y codedeebee mcp

或者全局安装：

npm install -g codedeebee
codedb mcp

npm 包名为 codedeebee（由于 codedb 名称在 npm 上已被占用）；它包含一个轻量级启动器，在 postinstall 阶段从 GitHub Releases 下载对应的原生二进制文件并验证 SHA256 校验和。安装后的 CLI 命令名称依然是 codedb。

适用于已使用 npx 的 MCP 客户端（如 Claude Code, Cursor, opencode, Claude Desktop）：

{
  "codedb": {
    "type": "local",
    "command": ["npx", "-y", "codedeebee"],
    "args": ["mcp"],
    "enabled": true
  }
}

更新或修复旧版本安装

如果旧版本的 codedb update 失败，请重新运行安装程序：

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

这将使用最新的 GitHub Release 二进制文件替换旧版 codedb，并保留您现有的 MCP 注册信息、配置、缓存和快照。对于内置更新程序无法获取校验和的版本，请使用此方式进行更新。

文档

• MCP 设置 — 各客户端配置（Claude Desktop, Cursor, VS Code, Claude Code, Codex CLI, Gemini CLI）、根目录解析、故障排除
• 技能库与上下文文件 — agents.md / CLAUDE.md / GEMINI.md, .codedbrc, 开发者个性化记忆
• CLI 参考 — 所有命令及参数说明
• 架构 — 引擎内部实现、索引布局
• 基准测试 — 微基准测试 + 与 codegraph, FTS5, lean-ctx 对比的 Agentic-eval 结果

平台	二进制文件	已签名
macOS ARM64 (Apple Silicon)	codedb-darwin-arm64	✅ 已签名 + 公证
macOS x86_64 (Intel)	codedb-darwin-x86_64	暂未签名
Linux ARM64	codedb-linux-arm64	—
Linux x86_64	codedb-linux-x86_64	—

或手动安装。