codebase-memory-mcp

环境要求

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

安装与启动步骤

1. 1macOS/Linux 一键安装

   README 提供的一行安装脚本，自动下载二进制并配置已检测到的编码助手的 MCP 条目、指令、技能与钩子。

   curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash

   复制

2. 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. 3安装选项（可选）

   不配置 agent 只装二进制用 --skip-config；安装到自定义目录用 --dir=。

4. 4手动下载安装（可选）

   从 latest release 下载对应平台压缩包，解压后运行包内 install 脚本；安装命令会自动去除 macOS 隔离属性并 ad-hoc 签名。

   tar xzf codebase-memory-mcp-*.tar.gz
   ./install.sh

   复制

5. 5重启编码助手

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

6. 6索引并验证

   在助手里说 "Index this project" 完成索引；用 /mcp 检查是否出现 codebase-memory-mcp 及其 15 个工具。

   /mcp

   复制

7. 7手动配置 MCP（可选）

   不想用 install 命令时，把 MCP 条目写入 ~/.claude.json（用户级）或项目 .mcp.json，然后重启助手。

   {
     "mcpServers": {
       "codebase-memory-mcp": {
         "command": "/path/to/codebase-memory-mcp",
         "args": []
       }
     }
   }

   复制

8. 8卸载

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

   codebase-memory-mcp uninstall

   复制

关键配置

如何确认成功

重启编码助手后用 /mcp 检查，应看到 codebase-memory-mcp 并列出 15 个工具；再说 "Index this project" 确认索引成功。

常见问题

注意事项

• 安装完成后必须重启编码助手，新的 MCP 配置才会生效。
• 该工具会读取你的代码库并向 agent 配置文件写入内容；如需先审计可查看完整源码。
• 手动安装时，安装脚本会自动处理 macOS 隔离属性并 ad-hoc 签名，无需手动 xattr/codesign。
• 配置项通过 codebase-memory-mcp config list / set / reset 命令管理。