codebase-memory-mcp

毫秒级索引代码库，让 AI 助手秒懂你的项目

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署编程开发 🍴 复刻 3999 🐛 待处理 564 👀 关注 165

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 48358

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT 许可证，完全免费，可自行部署使用。

项目预览

项目数据

分类编程开发

开发团队DeusData

官网地址https://deusdata.github.io/codebase-memory-mcp

GitHubhttps://github.com/DeusData/codebase-memory-mcp

定价模式🏷️完全免费

价格说明开源项目，MIT 许可证，完全免费，可自行部署使用。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言C

技术栈/模型aider,ast,claude-code,code-analysis,code-intelligence,codex,cursor,cypher,developer-tools,gemini-cli,graph-visualization,kilocode,knowledge-graph,mcp,mcp-server,model-context-protocol,opencode,sqlite,tree-sitter,windsurf

GitHub 星标★ 48358

上线时间2026-02-24 00:00:00

代码更新2026-11-07

仓库体积355.0 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数8

项目介绍

codebase-memory-mcp 是一个高性能的代码智能 MCP 服务器，将代码库索引为持久化的知识图谱，平均仓库索引时间仅需毫秒级。它支持 158 种编程语言，查询延迟低于亚毫秒，并能减少 99% 的 token 消耗。项目以单一静态二进制文件分发，零依赖，便于部署。它解决了 AI 编程助手（如 Claude Code、Cursor、Codex 等）在理解大型代码库时上下文窗口受限、token 成本高的问题，通过知识图谱提供精准的代码结构查询，显著提升代码分析的效率和准确性。核心能力包括快速索引、语义化查询、跨语言支持以及与主流 AI 编码工具的集成。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 48358

技术标签

aider ast claude-code code-analysis code-intelligence

使用教程

难度：入门约 5 分钟部署方式：本地安装 8 步

环境要求

macOS / Linux / Windows 桌面系统（提供对应平台的原生二进制包）
一个支持 MCP 的 AI 编码助手（如 Claude Code、Cursor、Codex、Gemini CLI 等）
无需语言运行时、云服务或 API key；macOS/Linux 需要能执行 curl 与 bash
Windows 需要 PowerShell，若受执行策略限制需先 Bypass

安装与启动步骤

1macOS/Linux 一键安装

README 提供的一行安装脚本，自动下载二进制并配置已检测到的编码助手的 MCP 条目、指令、技能与钩子。
```
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
```

2Windows 安装

先下载 install.ps1，再执行它。若被拦截可先执行 Set-ExecutionPolicy -Scope Process Bypass。

Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1
.\install.ps1

3安装选项（可选）

不配置 agent 只装二进制用 --skip-config；安装到自定义目录用 --dir=<path>。
4手动下载安装（可选）

从 latest release 下载对应平台压缩包，解压后运行包内 install 脚本；安装命令会自动去除 macOS 隔离属性并 ad-hoc 签名。
```
tar xzf codebase-memory-mcp-*.tar.gz
./install.sh
```
5重启编码助手

安装后必须重启你的编码助手，让它重新加载 MCP 服务器配置。
6索引并验证

在助手里说 "Index this project" 完成索引；用 /mcp 检查是否出现 codebase-memory-mcp 及其 15 个工具。
```
/mcp
```
7手动配置 MCP（可选）

不想用 install 命令时，把 MCP 条目写入 ~/.claude.json（用户级）或项目 .mcp.json，然后重启助手。
```
{
  "mcpServers": {
    "codebase-memory-mcp": {
      "command": "/path/to/codebase-memory-mcp",
      "args": []
    }
  }
}
```
8卸载

移除其写入的 agent 配置条目、技能、钩子、指令与已安装二进制；已有图谱索引会列出并在确认后删除。
```
codebase-memory-mcp uninstall
```

关键配置

配置项	必填	说明	示例
`auto_index`	否	是否在会话开始时自动索引代码库	`true`
`auto_index_limit`	否	自动索引允许的最大文件数上限	`50000`
`auto_watch`	否	是否注册后台 git watcher，默认为 true	`false`
`watcher_enabled`	否	是否彻底停止 watcher 线程，默认为 true	`false`