1 v0.2.0 更新于 2026-10-12

gen-system Understand MCP Server

解析代码库的相关事实:架构、调用图、控制流、副作用、推断。

适用客户端

本地客户端
Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端

安装配置

本地运行(npm)
{
  "mcpServers": {
    "gen-understand": {
      "command": "npx",
      "args": [
        "-y",
        "gen-understand"
      ]
    }
  }
}

将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。

提供的工具 接入后 Agent 可调用这 9 个工具

architecture
返回代码库的语言、主要包、入口点、调用解析情况以及解析器无法建模的部分
search_symbols
按名称搜索符号并排名,返回其他工具所需的符号 id
call_graph
从某个符号出发遍历调用边,无法解析的被调方显示为外部节点
control_flow
返回函数的基本块、块之间的边以及每个块内的源码行
source
返回某个符号的源代码
file_symbols
返回单个文件中的所有符号
effects
按影响分类(数据库、文件、网络、纯函数、未知)分组列出函数
beliefs
返回 belief 记录及其来源(解析器、模型或人工),可按例程、类型或验证状态过滤
correct_belief
仅在以 --allow-corrections 启动服务器时可用,用于人工修正 belief 记录