昆
昆仑AI工具大全KUN.NET
提交工具

codebase-memory-mcp 上手：在本机给代码仓库建知识图谱，查调用链、算改动影响面，再接入 Codex 和 Qwen Code

按 DeusData 官方 README（0.12.1 版）整理，无需 API Key、无需显卡：一行命令装好 codebase-memory-mcp，给 Flask 3.1.3 建本地知识图谱；用 search_graph、trace_path、get_code_snippet、search_code 和 Cypher 查符号、调用链和源码，用 detect_changes 算出改一行代码的影响面；再用 Python 走一遍 MCP 握手，一键接入 Codex 和 Qwen Code，通过 SSH 端口转发打开 CBM Lens，最后干净卸载。

入门3 课时70 分钟图文实操

免费学习无需登录

开始学习 查看课程目录
codebase-memory-mcp 上手：在本机给代码仓库建知识图谱，查调用链、算改动影响面，再接入 Codex 和 Qwen Code 课程封面

你将学会

  • 一行命令装好 codebase-memory-mcp
  • 给代码仓库建本地知识图谱
  • 读懂索引报告里的缺口
  • 用 trace_path 查调用链
  • 用 Cypher 统计和找无调用者函数
  • 用 detect_changes 算改动影响面
  • 用 check_index_coverage 判断索引是否过期
  • 用 Python 走一遍 MCP 握手
  • 接入 Codex 和 Qwen Code 并干净撤回
  • 打开 CBM Lens 可视化界面

适合谁

  • 用编程智能体写代码的开发者
  • 接手陌生代码库的工程师
  • 关注上下文工程的研究者和学生

课前准备

  • 会用 Linux 终端和 git
  • Linux 或 macOS
  • 会用 jq 取 JSON 字段
  • 课时 3 需要基础 Python

课程目录

3 课时 · 70 分钟
  1. 01一行装好 codebase-memory-mcp，给 Flask 建第一份索引用官方安装脚本加 --skip-config 装好 0.12.1，先不改动任何智能体配置；克隆 Flask 3.1.3，用 index_repository 建索引，看懂节点、边、未索引文件和部分解析文件这几项报告；用 list_projects、get_graph_schema、get_architecture、index_status 看图里有什么、索引存在哪里。图文20 分钟开始本课
  2. 02查符号、查调用链、跑 Cypher，再改一行代码算出影响面让后台进程常驻，用 search_graph 按名字和关键词找符号；用 trace_path 理清 Flask 处理一次请求的调用链，避开「类名.方法名」查不到的坑；用 get_code_snippet 只读一个方法，用 search_code 做带归属的文本搜索；用 Cypher 统计调用次数、列出没有调用者的函数并弄清为什么不能直接删；最后改一行代码，用 detect_changes 和 check_index_coverage 算出影响面、判断索引是否过期。图文30 分钟开始本课
  3. 03接入编程智能体：MCP 握手、Codex 和 Qwen Code 配置、CBM Lens 与干净卸载用几十行 Python 按 MCP 协议完成握手、列出 17 个工具并调用 trace_path；用 install --dry-run 预览，再一键接入 Codex 和 Qwen Code，看清写入的 MCP 配置、指引、技能、子智能体和钩子，附 Claude Code 手动配置；通过 SSH 端口转发打开 CBM Lens 的架构图和热点页；最后停掉常驻进程，用 uninstall 干净撤回。图文20 分钟开始本课

课程说明

codebase-memory-mcp 是 DeusData 开源的本地「代码知识图谱」MCP 服务器，MIT 许可，用纯 C 编写，发布成一个自带解析器和语义向量模型的单文件程序。它把代码仓库里的函数、类、调用、导入、文档章节和配置文件解析成一张持久保存在本机的图，再通过 17 个 MCP 工具（也可以直接在命令行里调用）回答「谁调用了它」「它会调用什么」「我改的这几行会波及哪里」这类结构性问题。它本身不带大模型，建索引和查询都在本机完成，不需要 API Key；Claude Code、Codex、Qwen Code 等编程智能体接上它以后，可以用一次图查询代替一遍遍 grep 和读整个文件。GitHub 上约 4.9 万星，当前正式版本是 2026 年 10 月 17 日发布的 0.12.1，自带可视化界面 CBM Lens（公开测试版）。

本课按官方 README（0.12.1 版）、安装脚本和项目主页整理。2026-11-14（Asia/Shanghai）在一台没有显卡的 Debian 13 x86_64 云主机上，用一个全新的 Linux 用户从零执行官方一行安装命令，装上 codebase-memory-mcp 0.12.1，拿 Flask 3.1.3 的源码做练习仓库。课里每一段命令都实跑过，「对照结果」都是这台机器的真实输出，只做了节选；测试用户名是 kunlab，你看到的路径会换成自己的家目录，进程号、耗时和少量计数会有小幅出入。课里也如实保留了几个容易踩的坑：用 类名.方法名 查调用链会报找不到、search_code 的 --file-pattern 写成目录通配会一无所获、浅克隆的仓库直接跑 detect_changes 会报找不到基准分支，并给出可用的写法。全程不需要任何 API Key 或付费模型。没有实测的有：macOS、Windows 上的运行，以及由 Codex、Qwen Code 等智能体驱动的完整对话。

官方资料