codedb 是一个面向 AI 编码代理的「代码情报（code intelligence）服务器」与 MCP 工具集，用 Zig 写成、原生支持 MCP、零外部依赖。它给代理提供对代码库的快速理解能力：结构化索引、trigram 搜索、词索引（标识符 O(1) 查找）、依赖图、文件监听，以及 tree/outline/symbol/search/read/edit/deps/snapshot 和远程 GitHub 仓库查询等共 16 个 MCP 工具。安装后会自动注册到 Claude Code、Codex、Gemini CLI、Cursor。它强调本地、隐私（HTTP 只绑 localhost、屏蔽 .env/凭据等敏感文件），并号称在预索引查询上比 ripgrep 快 538×。BSD-3-Clause、Alpha 阶段、约 824 星。
来源：README 顶部简介/Status/Install、GitHub meta（justrach/codedb，Zig，BSD-3-Clause） 查看 GitHub 仓库 →AI 编码代理要在大型代码库里高效工作，需要快速、结构化的「看代码」能力，而通用搜索（grep）缺乏结构理解、向量方案又重。codedb 用 Zig + 零依赖做了一个轻量但快的代码情报服务器：预索引后查询比 ripgrep 快两个数量级、提供结构化大纲与依赖图、以 16 个 MCP 工具直接喂给代理，安装即自动注册到主流代理。这种「给 agent 装一双快速、结构化的眼睛」的定位很实用，加上 Trendshift 曝光，使它受到关注（约 824 星，Alpha 期）。
来源：README Status（538x faster）/MCP Tools、GitHub meta（stars 824、created_at 2026-03-03、pushed_at 2026-05-22）提供 tree（目录树）、outline（结构大纲：函数/结构体/导入）、symbol、search（trigram）、read、edit（原子行范围编辑带版本跟踪）、deps（反向依赖图）、snapshot 等共 16 个 MCP 工具，并支持远程 GitHub 仓库查询，覆盖代理理解与修改代码的常见需求。
来源：README 顶部简介/Status（16 MCP tools）/MCP ToolsTrigram v2（整数文档 ID、批量累积、merge intersect）+ O(1) 倒排词索引做标识符查找，号称预索引查询比 ripgrep 快 538×；结构化大纲与可移植 snapshot 让 MCP 即时启动。
来源：README Status 表（trigram v2/538x/word index/snapshot）完整解析 Zig、C/C++、Python、TS/JS、Rust、Go、PHP、Ruby、HCL、R、Dart 等，轻量大纲覆盖 Java/Kotlin/Svelte/Vue/Astro/shell/CSS/SQL/protobuf 等；并构建反向依赖图，便于代理理解代码关系。
来源：README Status（Parser support/Lightweight outline/Reverse dependency graph）curl 一键安装后自动注册为 Claude Code/Codex/Gemini CLI/Cursor 的 MCP 服务器；HTTP 只绑 localhost、屏蔽 .env/凭据/密钥等敏感文件、单例 MCP 带 PID 锁与 1 小时空闲超时，macOS 二进制经签名公证、安装器校验 SHA256。
来源：README Status（auto-registration/sensitive file blocking/codesigned/singleton）/Installcodedb 是用 Zig（0.15）实现、零外部依赖的单二进制代码情报引擎。核心在 src/，对代码库做结构化索引：trigram v2 倒排索引（整数 docID、批量累积、merge intersect）+ O(1) 词索引 + 多语言解析器（生成函数/结构体/导入的大纲）+ 反向依赖图，并用轮询文件监听器加过滤目录遍历保持索引更新；可序列化为可移植 snapshot 供 MCP 即时启动。对外两种接口：MCP（JSON-RPC 2.0 over stdio，稳定）暴露 16 个工具，以及只绑 localhost 的 HTTP。运行为单例 MCP（PID 锁、1h 空闲超时）。仓库还含 bench/benchmarks/（对比 ripgrep、codegraph、FTS5、lean-ctx）、install/、docs/、experiments/。跨平台提供 macOS(ARM/x86，签名公证) 与 Linux(ARM/x86) 二进制。
来源：README Status/Architecture/Install、仓库目录树（src/bench/benchmarks/install/docs）、徽章（Zig 0.15）中心为项目本体，内环 = 核心功能模块，外环 = 关键技术依赖；按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成
零外部依赖（自研 trigram/词索引/解析器）MCP（stdio）+ 本地 HTTP多语言解析器（Zig/C/C++/Python/TS/Rust/Go 等）适合用 Claude Code/Codex/Cursor/Gemini CLI 在中大型代码库工作的开发者，想让代理更快、更结构化地理解与修改代码：用结构大纲快速摸清模块、用 trigram/词索引秒级定位符号与用法、用依赖图理清关系、用原子行编辑安全改动，并能查询远程 GitHub 仓库——相比让代理反复 grep 全库，更省时省 token。也适合关注本地、隐私（不外传、屏蔽敏感文件）的团队，或研究「用 Zig 做零依赖代码索引/MCP 服务器」的开发者。
来源：README MCP Tools/Status/Quick Start项目处于 Alpha，通过 GitHub Releases 发版（提供 macOS ARM/x86 签名公证与 Linux ARM/x86 二进制），curl 一键安装并自动注册。README 记录了 v0.2.579 的 MCP 热修与各平台 SHA256 校验。功能已覆盖 16 个 MCP 工具、trigram v2、词索引、依赖图、文件监听与可移植 snapshot。最近一次更新在 2026-05-22。
来源：README Status/Install（v0.2.579 hotfix）、GitHub meta pushed_at 2026-05-22、created_at 2026-03-03codedb 给 AI 编码代理补上了「快速、结构化地看代码」这块短板：Zig 写的零依赖单二进制，提供 16 个 MCP 工具（大纲、trigram 搜索、依赖图、原子编辑等），预索引查询号称比 ripgrep 快两个数量级，安装即自动接入 Claude/Codex/Cursor/Gemini，还本地化、屏蔽敏感文件、macOS 签名公证。对在中大型代码库用代理、想让它少 grep 多理解的开发者很实用，性能与隐私取向都对路。要清楚它仍是 Alpha——API 与 snapshot 格式可能变、部分语言只有轻量大纲、curl|bash 需先审阅、HTTP 无鉴权。作为「给 agent 装一双快眼睛」的代码情报 MCP 服务器，它的性能与工程取向很有竞争力，值得在其稳定推进时持续关注。
来源：综合 README、Status、MCP Tools 与 GitHub meta 的事实判断