DeusData/codebase-memory-mcp 是一个代码智能 MCP server。它会把代码库索引成持久知识图谱，让 Claude Code、Codex、Gemini CLI、Aider、OpenCode 等 Agent 更快查询项目结构。
项目地址：
https://github.com/DeusData/codebase-memory-mcp
文档站：
https://deusdata.github.io/codebase-memory-mcp/
一键安装
macOS / Linux：
1
|
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
|
如果想同时安装图形界面：
1
|
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash -s -- --ui
|
Windows：
1
2
3
4
5
6
7
8
|
# 1. Download the installer
Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1
# 2. (Optional but recommended) Inspect the script
notepad install.ps1
# 3. Run it
.\install.ps1
|
手动安装
macOS / Linux 解压后安装：
1
2
|
tar xzf codebase-memory-mcp-*.tar.gz
./install.sh
|
Windows：
1
2
|
Expand-Archive codebase-memory-mcp-windows-amd64.zip -DestinationPath .
.\install.ps1
|
打开 UI
1
|
codebase-memory-mcp --ui=true --port=9749
|
自动索引和更新
开启自动索引：
1
|
codebase-memory-mcp config set auto_index true
|
更新：
1
|
codebase-memory-mcp update
|
卸载：
1
|
codebase-memory-mcp uninstall
|
适合怎么用
它适合代码库比较大、Agent 经常反复读文件的场景。比如：
- 老项目结构复杂，AI 总是找错入口。
- 多语言仓库里需要快速查依赖关系。
- 想减少 Agent 把大量文件塞进上下文。
- 希望用 MCP 给多个编码工具共享同一份代码记忆。
安装后建议先让 Agent 做一个小任务：解释项目结构、找到某个 API 的调用链、定位某个配置入口。确认它能正确查询后，再用于真实改代码任务。