codebase是一款代码索引工具，方便对大行项目进行索引构建目录结构

1. 下载安装

下载地址：

Releases · DeusData/codebase-memory-mcp · GitHub

可以直接下载release发布包，以下载安装linux-arm机器为例：

注意，下载codebase-memory-mcp-ui-linux-arm64-portable.tar.gz这个版本，自带依赖库，否则运行时会依赖glibc_2.34,机器自带的glibc版本不够

解压安装包并赋值可执行权限

tar -zxvf codebase-memory-mcp-ui-linux-arm64-portable.tar.gz

chmod +x *

查看是否安装成功

./codebase-memory-mcp --version

根据自己需求，启动UI界面服务（仅作为AI MCP服务时不用起）

./codebase-memory-mcp --ui --port 9749

注意：

目前ui功能有缺陷：

• 只能绑定本地回环地址127.0.01，当服务在linux服务器启动时，通过windows无法直接连接
• 不能后台启动&

问题1解决方法：

使用隧道，在winows powershell上运行：

ssh -L 9749:127.0.0.1:9749 fanzc@192.168.86.151

其中：

• 9749是服务启动时绑定的端口
• fanzc@192.168.86.151：是服务启动的用户:ip

成功连接界面：

2. 给AI助手使用

运行install命令

在上面的安装目录下运行：./codebase-memory-mcp install

该指令将实现把可执行程序拷贝到~/.local/bin目录，同时自动更新claude的.mcp.json文件，实现向claude注册mcp

重启claude

通过/mcp命令可见codebase的mcp已添加

进行代码检索时，会自动调用该mcp