codebase-memory-mcp (CBM) — 安装与自动化记录
安装日期：2026-07-30
当前版本：v0.9.0
上游：https://github.com/DeusData/codebase-memory-mcp
Gitea：http://192.168.123.11:3000/xiaoxue_admin/codebase-memory-mcp
论文：arXiv:2603.27277
相关 skill：cbm-code-analysis（代码分析自动调用）
文件位置
安装步骤（2026-07-30）
# 1. 下载 release binary（GFW 规避：先代理，直连保底）
curl -fsSL --max-time 300 \
"https://gh-proxy.com/https://github.com/DeusData/codebase-memory-mcp/releases/latest/download/codebase-memory-mcp-linux-amd64.tar.gz" \
-o /tmp/cbm.tar.gz
# 代理 28MB/37MB 超时后，直连反而成功
# 2. 解压
cd /tmp && tar xzf cbm.tar.gz
# 3. 安装 binary
mkdir -p ~/.local/bin
cp /tmp/codebase-memory-mcp ~/.local/bin/
chmod 755 ~/.local/bin/codebase-memory-mcp
# 4. 自动配置客户端
codebase-memory-mcp install -y
# 配了 OpenCode MCP + AGENTS.md + OpenClaw MCP
# 5. 额外配 Hermes MCP（交互式确认用 echo "Y" 管道）
echo "Y" | hermes mcp add codebase-memory-mcp \
--command /home/muc/.local/bin/codebase-memory-mcp
# 8/8 tools enabled
验证
codebase-memory-mcp --version # v0.9.0
hermes mcp list # 应显示 codebase-memory-mcp ✓ enabled
codebase-memory-mcp cli list_projects # 列出已索引项目
8 个 MCP 工具
| 工具 |
用途 |
index_repository |
索引项目到知识图谱 |
search_graph |
按名称/标签/文件搜索节点 |
query_graph |
Cypher 查询（read-only 子集） |
trace_path |
BFS 调用链追踪（入站/出站） |
get_code_snippet |
按 qualified name 读源码 |
get_graph_schema |
图谱结构（节点/边类型） |
get_architecture |
项目架构概览（包/路由/热点） |
search_code |
图谱增强的 grep 搜索 |
自动化体系
看门狗监控
- 脚本：
~/.hermes/scripts/health-watchdog.sh
- 进程名：
codebase-memory-mcp（别名 cbm）
- 挂了自动
systemctl --user start
- 每30min检查 → 异常飞书告警 → 恢复通知
自动索引 cron
- ID:
fd4fab3ddb5a
- 调度：每天 3:00 AM
- 模式：no-agent watchdog
- 职能：git pull 织忆项目 →
index_repository → 刷新 ~/.hermes 索引
代码分析 skill
- 名：
cbm-code-analysis（software-development 分类）
- 触发词见 SOUL.md "CBM 代码图谱自动调用规则"
- 优先用图查询替代 grep/文件遍历
索引统计（2026-07-30）
| 项目 |
路径 |
节点 |
边 |
| ~/.hermes（大脑配置） |
~/.hermes/ |
146,012 |
622,921 |
| 织忆（Go 项目） |
/tmp/memoryweave/ |
5,331 |
20,403 |
与织忆的关系
- CBM = 代码知识图谱（函数/类/调用链）
- 织忆 = 语义/对话记忆（用户偏好/上下文）
- 互补关系，不冲突
已知问题
- 二进制 270MB（含 vendored tree-sitter 158 语法 + mimalloc + sqlite3）
- 有 crash 文件时 worker 会 exit_nonzero，重试即可（不持久损坏）
- 数据存
~/.cache/codebase-memory-mcp/