🧠 codebase-memory-mcp
面向AI编程智能体的最快代码智能引擎
纯C实现 · 158种语言 · 99% Token降低
🔧 零依赖
📦 单二进制文件
📝 项目简介
codebase-memory-mcp 是由 DeusData 团队开发的高性能代码智能MCP（Model Context Protocol）服务器，将代码库索引为持久化知识图谱，让AI编程智能体能够像资深工程师一样”理解”代码库结构。
项目采用纯C语言实现，无任何运行时依赖，单静态二进制文件即可运行。支持158种编程语言，查询响应达到亚毫秒级，相比逐文件搜索可降低99.2%的Token消耗。
⚙️ 安装要求和过程
环境要求
- macOS（arm64/amd64）、Linux（arm64/amd64）、Windows（amd64）
- 无需Docker、无需运行时依赖、无需API密钥
- 纯C实现，单静态二进制文件即可运行
快速安装
macOS / Linux 一键安装：
# 标准版本
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
# 带可视化UI版本
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash -s -- --uiWindows PowerShell 安装：
# 1. 下载安装脚本
Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1
# 2. 执行安装
.\install.ps1包管理器安装：
# npm
npm install -g codebase-memory-mcp
# PyPI
pip install codebase-memory-mcp
# Homebrew (macOS)
brew install deusdata/tap/codebase-memory-mcp
# Scoop (Windows)
scoop install codebase-memory-mcp⭐ 核心功能
极致索引速度
Linux内核（2800万行代码、7.5万个文件）全量索引仅需3分钟。内存优先流水线设计，索引完成后自动释放内存，不影响开发环境性能。
14个MCP工具
通过MCP协议提供14个代码分析工具，包括：架构概览、调用链追踪、语义搜索、BM25全文搜索、类Cypher图查询、Git差异影响映射、死代码检测等。
混合LSP语义解析
为Python、TypeScript/JavaScript、PHP、C#、Go、C/C++、Java、Kotlin、Rust等9种语言提供混合LSP语义解析，解决tree-sitter仅能做语法解析的局限，大幅提升调用链解析准确性。
多代理自动适配
install命令自动检测11种主流编程智能体（Claude Code、Codex CLI、Gemini CLI、VS Code、Aider、Cursor等），自动配置MCP入口、指令文件、钩子等，无需手动操作。
内置3D知识图谱可视化
可选UI版本启动后可通过 localhost:9749 访问3D交互式知识图谱，直观查看代码库结构、函数调用关系、模块依赖等，让代码理解更直观。
🚀 典型使用场景
场景一：大型代码库快速理解
面对百万行级别的大型代码库，AI智能体通过codebase-memory-mcp可以在亚毫秒级时间内回答”哪些函数调用了ProcessOrder？””这个模块的核心依赖是什么？”等问题，而无需逐文件搜索。
效果对比：5次结构查询仅需约 3,400 token，而逐文件搜索需要约 41.2万 token，Token消耗降低 99.2%。
场景二：多仓库架构分析
支持多仓库索引，生成跨仓库调用关联，支持多仓库架构可视化。对于微服务架构、 monorepo 项目，可以建立跨服务的调用关系图谱，帮助AI理解分布式系统架构。
场景三：代码变更影响分析
通过Git差异影响映射功能，在修改代码前可以精确分析”修改这个函数会影响哪些模块？”，帮助AI智能体生成更安全、更全面的代码修改方案，减少引入Bug的风险。
💡 推荐理由
作为一名经常使用AI编程智能体的开发者，codebase-memory-mcp 解决了我最大的痛点：AI在理解大型代码库时效率低下、Token消耗巨大。
传统的RAG方案需要将代码文件切块后向量化存储，查询时再做语义搜索，存在上下文丢失和精度不足的先天缺陷。codebase-memory-mcp 则采用了更优雅的方案：
- 知识图谱 + 混合LSP：不仅捕获语法结构，还通过LSP获取精确的语义类型信息
- 纯C实现：性能极致，索引Linux内核仅需3分钟
- 零依赖单二进制：下载即可用，不需要配置Python/Node.js环境
- MCP原生：与Claude Code/Cursor/Aider等主流AI编程工具无缝集成
特别值得一提的是项目的安全合规：通过OpenSSF Scorecard安全评分、SLSA 3级构建溯源标准、VirusTotal 70+杀毒引擎扫描，全部二进制均经过严格安全检测，适合企业级使用。
⚡ 使用技巧：安装完成后，对AI智能体说”索引这个项目”，它会自动调用MCP工具完成代码库知识图谱构建。之后你就可以问它任何关于代码库结构的问题了！
📥 下载地址
📄 许可证：MIT License（完全开源，可自由使用、修改和分发）
📝 学术论文：arXiv:2603.27277
🔒 安全认证：OpenSSF Scorecard + SLSA 3级 + VirusTotal 70+引擎扫描通过
发表回复