codebase-memory-mcp 极简完整使用指南

1. 一键安装（macOS / Linux）

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

带 UI 可视化版本：

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

安装内容：

• 二进制：~/.local/bin/codebase-memory-mcp
• Claude 配置：自动写入 ~/.claude.json
• 索引缓存：~/.cache/codebase-memory-mcp/

2. 验证安装成功

执行三条命令：

which codebase-memory-mcp
codebase-memory-mcp --version
claude mcp list | grep codebase-memory-mcp

出现以下结果即为成功：

• 路径正常显示
• 版本号 0.6.x
• claude mcp list 显示 connected ✓

必须重启 Claude Code 才能生效！

3. 如何让 AI 自动使用它

只要你说这些话，Claude 会自动调用 codebase-memory：

• 探索代码库 / 理解架构
• 列出函数 / 查看结构
• 谁调用了这个函数 / 调用链
• 依赖分析 / 改动影响
• 死代码 / 未使用函数
• 给我架构概览

强制触发（最稳）：

用 codebase memory 索引这个项目

用 codebase memory 分析调用链

4. 核心 CLI 命令

索引当前项目

codebase-memory-mcp cli index_repository '{"repo_path":"'$(pwd)'"}'

查看已索引项目

codebase-memory-mcp cli list_projects '{}'

搜索函数/类

codebase-memory-mcp cli search_graph '{"name_pattern":".*Handler.*","label":"Function"}'

追踪函数调用链

codebase-memory-mcp cli trace_path '{"function_name":"你的函数名","direction":"both"}'

查看项目架构

codebase-memory-mcp cli get_architecture '{"project":"项目名"}'

5. 批量索引多个 Git 仓库（脚本）

保存为 cbm-index.sh：

#!/usr/bin/env bash
set -euo pipefail

for parent in "$@"; do
  for repo in "$parent"/*/; do
    repo="${repo%/}"
    if [ -d "$repo/.git" ]; then
      echo "索引：$repo"
      codebase-memory-mcp cli index_repository "$(printf '{"repo_path":"%s"}' "$repo")"
    fi
  done
done

echo "已索引项目："
codebase-memory-mcp cli list_projects '{}'

运行：

chmod +x cbm-index.sh
./cbm-index.sh ~/Workspaces

6. 取消索引 / 删除数据

查看索引列表

codebase-memory-mcp cli list_projects '{}'

删除单个项目索引

codebase-memory-mcp cli delete_project '{"project":"项目全名"}'

清空所有索引

rm -rf ~/.cache/codebase-memory-mcp

关闭自动索引

codebase-memory-mcp config set auto_index false

7. 完整卸载

codebase-memory-mcp uninstall
rm -f ~/.local/bin/codebase-memory-mcp
rm -rf ~/.cache/codebase-memory-mcp

然后重启 Claude Code。

8. 常见问题（10 秒解决）

❌ AI 还是用 find/grep

解决：重启 Claude Code + 说关键词：用 codebase memory

❌ command not found

export PATH="$HOME/.local/bin:$PATH"

❌ project not found

重新索引当前目录：

codebase-memory-mcp cli index_repository '{"repo_path":"'$(pwd)'"}'

❌ 索引把多个项目合并了

必须按 Git 仓库单独索引，不要索引父目录。

9. UI 可视化（如果安装了 --ui）

访问：

http://localhost:9749

可查看：

• 3D 代码知识图谱
• 函数调用关系
• 类依赖
• 模块架构