codedb-mcp（又称 codebase-mcp）是基于 Rust 的 MCP 服务器，可将本地代码仓库转换为持久化的代码智能服务。它在项目 .codedb-mcp/ 目录下维护 tree-sitter 索引数据库，包含符号、引用、依赖、图元数据、词法索引与向量嵌入，用于快速语义搜索，全部数据本地存储，无云依赖。
主要能力：毫秒级热查询；codedb_context 与 codedb_explore 返回排序后的相关代码上下文而非整文件；基于依赖图的模块发现；类 LSP 的符号定义、调用者、大纲与引用导航；Code Module Atlas 三维可视化；DeepWiki 自动生成带引用的文档。
安装需 Rust 工具链、Node.js 与待索引的 Git 仓库。从源码构建：git clone https://github.com/killop/codedb-mcp.git 后执行 cargo build --release，产物位于 target/release/codedb-mcp。在目标项目创建 .codedb-mcp/codedb-mcp.toml 配置，再运行 /path/to/codedb-mcp --project-root . index 建立初始索引。在 MCP 设置中以 command 指向该二进制、args 为 --project-root 与 serve 启动。
核心工具包括 codedb_index、codedb_status、codedb_symbol、codedb_outline、codedb_callers、codedb_text_search、codedb_search、codedb_word、codedb_context、codedb_explore、codedb_deps、codedb_read、codedb_tree、codedb_hot、codedb_bundle 等；向量搜索模型默认 minishlab/potion-code-16M，首次使用时懒加载。
适用于理解新功能、重构影响分析、架构探索与增量索引更新。资料给出在 u3dclient Unity C# 项目上的基准：18,852 个文件冷索引 13.8s、热命中 0.741s。限制：需自行构建与配置，向量模型需从 HuggingFace 获取；其他平台兼容性、许可证与收费情况暂未提供。