codebase-memory-mcp 是本地代码库向量记忆MCP服务用于给Claude建立代码知识库、跨会话记忆项目架构、接口、业务逻辑分一键脚本安装推荐、手动二进制部署、源码编译三种方案分别适配 Claude Desktop 桌面客户端与终端 Claude Code。一、一键自动安装自动写入Claude配置最简单macOS / Linux终端执行# 标准版无可视化图谱UIcurl-fsSLhttps://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh|bash# 带3D知识图谱可视化UI版本curl-fsSLhttps://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh|bash-s----ui# 仅安装二进制不自动修改任何AI工具配置curl-fsSLhttps://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh|bash-s-- --skip-configWindowsPowerShell管理员Invoke-WebRequest-Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1-OutFile install.ps1.\install.ps1# 带UI版本.\install.ps1-ui# 仅二进制不自动配置.\install.ps1-skip-config脚本会下载对应系统静态二进制Go单文件无运行时依赖自动识别本地 Claude Desktop / Claude Code写入MCP配置自动添加PATH全局命令codebase-memory-mcp二、手动安装源码/二进制包适合自定义路径方式1下载预编译二进制打开 Releasehttps://github.com/DeusData/codebase-memory-mcp/releases下载对应系统包macOS arm64(M系列) / x86Linux amd64Windows amd64解压赋予执行权限mac/Linux# macOS/Linuxchmodx codebase-memory-mcpmvcodebase-memory-mcp ~/.local/bin/# 验证codebase-memory-mcp--version方式2本地Go源码编译需Go1.23gitclone https://github.com/DeusData/codebase-memory-mcp.gitcdcodebase-memory-mcpCGO_ENABLED1go build-ocodebase-memory-mcp ./cmd/codebase-memory-mcp/# 移动到全局目录sudomvcodebase-memory-mcp /usr/local/bin三、分别配置两种Claude客户端场景AClaude Desktop桌面App找到配置文件路径macOS~/Library/Application Support/Claude/claude_desktop_config.jsonWindows%APPDATA%\Claude\claude_desktop_config.jsonLinux~/.config/Claude/claude_desktop_config.json写入MCP配置{mcpServers:{codebase-memory:{command:codebase-memory-mcp,args:[]}}}若二进制不在PATH替换command为绝对路径例/Users/xxx/.local/bin/codebase-memory-mcp完全关闭重启 Claude Desktop场景BClaude Code终端CLInpm全局安装全局可用所有项目共享记忆claude mcpadd--scopeuser codebase-memory -- codebase-memory-mcp仅当前项目生效claude mcpaddcodebase-memory -- codebase-memory-mcp查看已加载MCP服务验证claude mcp list# 输出包含 codebase-memory 即成功项目本地配置文件.mcp.json团队共享项目根目录新建.mcp.json{mcpServers:{codebase-memory:{command:codebase-memory-mcp}}}四、初始化与使用重启Claude后直接对话指令建立代码库索引首次必执行Index this project记忆项目关键信息记住这个项目使用Gin框架用户登录接口是POST /api/loginJWT存在redis查询历史记忆回顾这个项目的数据库设计与权限逻辑打开图谱可视化带UI版本Show memory graph五、常见问题排错macOS 提示无法验证开发者xattr-cr~/.local/bin/codebase-memory-mcpcodebase-memory-mcp命令找不到确认二进制目录加入PATH或配置文件写绝对路径Claude识别不到MCP服务完全退出App/终端重新打开执行/mcpClaude Code查看加载列表索引代码报错无权限给项目文件夹完整读写权限关闭项目内.gitignore屏蔽的超大文件目录六、卸载一键卸载脚本# mac/linuxcurl-fsSLhttps://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/uninstall.sh|bash# Windows PowerShell.\uninstall.ps1手动清理删除二进制rm ~/.local/bin/codebase-memory-mcp从claude_desktop_config.json删除 codebase-memory 配置块Claude Code移除MCPclaude mcp remove codebase-memory删除本地记忆库项目根目录.codebase-memory/文件夹