justrach/codedb

⭐ 589 Stars 🍴 37 Forks Zig BSD-3-Clause

justrach/codedb 是一个基于 Zig 编写的代码智能服务器和 MCP 工具集,旨在为 AI 代理提供快速、高效的代码索引和查询功能。

来源:据 README 描述 查看 GitHub 仓库 →

为什么值得关注

该项目因其独特的 Zig 语言实现、高效的代码索引和查询能力,以及为 AI 代理提供的强大支持而受到关注。它填补了现有代码智能工具在 Zig 语言支持方面的空白,并提供了独特的 Trigram 搜索技术。

来源:综合 README 描述和项目特征

核心功能

代码智能

提供快速、全面的代码索引,包括树状结构、符号、搜索、读取、编辑、依赖关系、快照和远程 GitHub 仓库查询。

来源:据 README 描述
MCP 工具集

提供 16 个 MCP 工具,支持代码库的全面智能,包括文件树、符号列表、符号查找、全文搜索、词索引、热文件、依赖图、文件读取、编辑、变更跟踪等。

来源:据 README 描述
Trigram 搜索

采用 Trigram 搜索技术,实现快速全文搜索,支持正则表达式和范围搜索。

来源:据 README 描述

技术架构

项目采用模块化设计,代码目录结构清晰,包括 .github、bench、docs、install、scripts、src 等目录。依赖文件信息不足,但根据代码结构,项目可能使用了 Zig 语言和 JSON-RPC 2.0 协议。数据流转主要通过 MCP 工具集实现。

来源:代码目录结构 + 依赖文件

技术栈

infra: 信息不足,待补充  |  key_deps: JSON-RPC 2.0  |  language: Zig  |  framework:

来源:依赖文件 + 代码目录结构

快速上手

curl -fsSL https://codedb.codegraff.com/install.sh | sh # 手动安装 # 从 GitHub Releases 下载对应平台的二进制文件。 # 运行 MCP 服务器 codedb mcp /path/to/your/project # 运行 HTTP 服务器 codedb serve /path/to/your/project
来源:README Installation/Quick Start

使用场景

适用于需要快速代码索引和查询功能的 AI 代理开发,例如代码搜索、代码编辑、代码分析等场景。适用于 Zig 语言开发者和需要跨平台支持的团队。

来源:README

优势与局限

优势

  • 优势1:基于 Zig 语言,性能高效;优势2:提供全面的代码智能功能;优势3:支持多种编程语言;优势4:易于安装和使用。

局限

  • 局限1:处于 Alpha 阶段,API 可能会变化;局限2:目前只支持 Zig 语言;局限3:没有认证机制;局限4:快照格式可能会变化。
来源:综合 README、代码结构和依赖分析

最新版本

v0.2.54 (2026-04-06): mmap-backed trigram index, Trigram v2, Installer Fix + Correct Linux Binary, Memory, Parser, Reliability (Linux hotfix), Security Hardening & Performance

来源:GitHub Releases

总结评价

justrach/codedb 是一个值得关注的开源项目,对于需要高效代码智能功能的 Zig 语言开发者来说,它是一个强大的工具。由于其仍处于 Alpha 阶段,建议对稳定性有较高要求的用户谨慎使用。

来源:综合分析
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间:2026-04-07 00:34。质量评分:85/100。 所有结论均标注了数据来源。如发现不准确之处,欢迎反馈。

数据来源: README、GitHub API、依赖文件