DeusData/codebase-memory-mcp

项目概览

可重点验证其对 158 种语言的 tree-sitter 索引，以及针对 Linux 内核 2800 万行代码给出的 3 分钟索引结果能否在自身代码库上复现。

项目类型

MCP · AI 编程 · AI 搜索

应用场景

知识问答 · 编程开发

部署方式

查看项目说明

License

MIT

适合谁

• 适合已经使用 MCP 编码代理，并希望把本地代码库结构、调用关系和语义搜索作为代理上下文来源的开发团队。
• 适合对源码本地处理、默认关闭遥测和不依赖付费服务有明确要求的个人或团队。
• 适合需要分析跨文件调用、服务接口关联、改动影响或零调用者函数的代码维护场景。

核心能力

• 当前可用。通过 tree-sitter AST 分析完整索引代码库，形成包含函数、类、调用链、HTTP 路由和跨服务链接的持久化知识图谱，覆盖 158 种语言；用户可复用该图进行结构探索，而不必每次从文件搜索开始。
• 当前可用。项目以轻量 C 实现的语言类型解析算法补充 tree-sitter，支持 Python、TypeScript、JavaScript、JSX、TSX、PHP、C#、Go、C、C++、Java、Kotlin、Rust 和 Perl，用于增强这些语言的类型关系解析。
• 当前可用。项目把 Nomic 的 nomic-embed-code 嵌入编译进二进制文件，并结合 TF-IDF、RRI、AST 特征和数据流等 11 类信号对全图搜索结果评分，帮助代理从代码图谱中定位相关实体。
• 当前可用，但需要选择带界面的二进制变体。交互式三维界面运行于本机 localhost:9749，可用于浏览代码库知识图谱；不需要可视化的部署可以不采用该变体。
• 当前可用。用户可用 MATCH、关系类型、WHERE 和 RETURN 等类 Cypher 表达方式遍历知识图谱，例如查询 main 函数调用的目标，适合需要明确关系条件的结构分析。
• 当前可用。安装过程可检测并配置 MCP 条目、持久指令、技能和生命周期钩子，覆盖 43 个自动或有条件支持的客户端界面；其价值是减少逐个客户端配置，但安装程序会写入代理配置文件。
• 当前可用，且自动行为为可选项。项目可在首次连接时索引新项目，并通过后台监视器持续检测基于 Git 的变更；团队可配置相关限制，以控制持续更新行为。
• 当前可用。每个 MCP 工具均可通过命令行调用，因此索引和查询可以在没有交互式客户端界面的无头流程中执行。

限制与风险

• 项目本身不提供语言模型，完全依赖连接的 MCP 客户端处理自然语言。因此，它提供的是代码结构与检索层，不能单独完成自然语言问答。
• 项目没有为 Cursor 启用上下文钩子，给出的原因是会话注入存在竞争情况，且只读状态会阻止 MCP；选型时不能把其他客户端的钩子行为直接套用于 Cursor。
• Cline 的子代理无法使用 MCP，项目也没有为其启用自动文件钩子；依赖子代理或文件事件自动触发的工作流需要单独验证。
• 工具会读取代码库并写入代理配置文件，采用者需要信任或审查安装脚本，尤其要关注 MCP 条目、持久指令、技能和生命周期钩子的变更。
• 项目资料没有给出最低硬件配置。虽然项目报告平均仓库可在毫秒级完成完整索引、Linux 内核 2800 万行代码约需 3 分钟，但实际结果仍应在目标设备和代表性仓库上测量。

如何开始

• macOS、Linux 可使用项目提供的 curl 安装脚本，Windows 可使用 PowerShell 安装脚本；运行安装程序后重启代理，安装过程会检测并配置受支持的客户端。
• 安装程序会读取代码库并写入代理配置文件。受控环境应在执行前检查脚本、目标配置文件及生命周期钩子，确认变更范围符合团队要求。
• 安装并重启代理后，可先对一个代表性仓库建立索引，再通过 MCP 或命令行验证函数、调用关系和路径查询；如需持续更新，再启用首次连接自动索引与后台变更监视。

核验依据

• GitHub 项目简介: High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens.…
• README: The fastest and most efficient code intelligence engine for AI coding agents. Full-indexes an average repository in milliseconds, the Linux kernel (28M LOC, 75K files) in 3 minute…
• README: Plug and play — single static binary for macOS (arm64/amd64), Linux (arm64/amd64), and Windows (amd64). No Docker, no runtime dependencies, no API keys. Download → install → resta…
• README: **One-line install** (macOS / Linux): ```bash curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash ``` With graph visualization UI: ```…
• README: The install command auto-detects installed coding agents and configures their documented MCP entries plus durable instructions, skills, and lifecycle hooks where supported.

内容核验时间：