Claude 必备技能 codebase-memory-mcp

一、它是什么

codebase-memory-mcp 是开源本地MCP服务程序 （MCP=Model Context Protocol，Anthropic推出的AI通用插件协议），专门给 Claude Desktop / Claude Code、Cursor、VSCode Copilot 等AI编程工具做代码全局记忆引擎。简单拆解：

身份：独立本地程序（单文件C静态二进制，无外部依赖，代码全程不离开本机）
核心底层 ：Tree-Sitter 解析代码AST + Hybrid LSP语义分析，把整个项目构建成代码知识图谱（存在本地SQLite）
通信标准：遵循MCP协议，Claude可以直接调用它内置的14种代码查询工具
定位：给AI提供全局代码架构记忆，解决原生AI只会逐文件读代码、耗Token、看不清调用关系的痛点

二、核心作用（解决什么痛点）

1. 大幅节省Token，提升Claude响应速度

原生Claude分析项目逻辑：反复读取成千上百个文件、全文检索，Token消耗极高、慢、容易截断上下文。 codebase-memory-mcp：提前把所有代码结构、调用关系存入图谱，Claude只需结构化图查询，Token消耗减少最高120倍，查询亚毫秒级返回结果。

2. 让Claude拥有项目全局记忆（跨会话持久存储）

初次执行 Index this project 完成全库索引，生成 .codebase-memory 本地数据库；
关闭Claude、重启电脑，记忆不会丢失；
代码修改自动增量更新图谱，不用每次全量重建；
支持手动记忆业务规则：记住本项目JWT存在Redis，登录接口POST /api/user/login，后续对话AI自动调取记忆。

3. 完整代码结构图谱分析（AI原生做不到）

图谱节点：文件、类、函数、接口、数据库表、HTTP路由、常量图谱关联边：调用、继承、导入、依赖、重写、跨模块引用内置工具可直接查询：

调用链追踪：某个函数被哪些地方调用、调用了哪些底层方法
影响范围分析：修改这个接口会影响哪些页面/模块
死代码检测：未被调用的函数、废弃接口
架构分层梳理：自动区分控制器、服务、DAO层
跨文件依赖检索、循环依赖定位
支持类Cypher图语句自定义复杂代码查询

4. 支持超大仓库、超多编程语言

支持158种编程语言：JS/TS、Java、Go、Python、Vue、C/C++、鸿蒙ArkTS、PHP等主流开发语言
性能极强：中小型项目几秒索引；Linux内核2800万行代码仅3分钟完成全量图谱构建

5. 可选3D可视化图谱UI

安装带 --ui 参数版本后，访问 localhost:9749 可视化查看整个项目代码拓扑，直观看懂模块依赖、核心入口函数、代码孤岛。

6. 完全本地离线、隐私安全

所有代码解析、向量图谱、记忆数据库全部存在本机
无网络上报、无遥测、不需要API Key，不会上传你的项目代码到第三方服务器

三、和普通代码RAG、原生Claude文件读取的区别

能力	原生Claude读文件	普通代码RAG（文本切块）	codebase-memory-mcp知识图谱
代码结构理解	弱，只看文本片段	中等，仅文本相似度匹配	极强，完整AST+调用拓扑
调用链/依赖分析	几乎无法完整分析	很难跨文件追踪	原生图遍历，一键全链路
Token消耗	极高	中等	降低90%~120倍
持久化记忆	关闭会话即清空	仅文本片段记忆	完整架构永久本地存储
大型仓库性能	卡顿、上下文溢出	索引慢、查询不准	毫秒级查询，支持千万行代码

四、日常开发实用场景

接手陌生老项目：一键索引，让Claude梳理整体架构、核心流程、数据库交互
大型后端业务修改：改一个核心方法前，查询全部调用方，避免漏改产生bug
接口迭代：快速找出所有使用该接口的前端页面、定时任务、第三方调用
代码重构/清理：自动找出死代码、循环依赖、冗余导入
跨会话连贯开发：今天写登录模块，明天打开Claude依然记得项目鉴权、缓存逻辑
架构复盘：3D图谱直观展示项目模块划分，辅助写架构文档

五、简单使用流程

安装二进制并写入Claude Desktop MCP配置
重启Claude，对话输入 Index this project 构建代码图谱
直接提问：
- "梳理这个项目用户登录完整调用链"
- "修改UserService.login会影响哪些接口"
- "找出项目里所有未被调用的接口函数"
- "记住项目统一异常处理逻辑，之后写接口自动复用"
输入 Show memory graph 打开可视化图谱面板