gen-system Understand

Name: gen-system Understand
Author: hpdkhoa

本地服务

github.com/hpdkhoa开发工具31 周前更新

代码仓库

关于 gen-system Understand

gen-system Understand 是面向代码库分析的只读 MCP 服务，供 Agent 查询结构信息。它以多种语言的确定性解析器提供代码事实，并在本地运行，不向外发送数据。

主要功能

01架构与符号查询
02调用图与控制流图
03源码与文件符号
04影响与例程信念
05可选的信念修正

适用场景

01追踪例程间调用
02检查例程控制流
03搜索仓库中的符号

MCP 相关

通过 MCP 工具提供代码库架构、符号、图结构、源码、影响和信念；启用后还可提供信念修正工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "hpdkhoa-gen-understand": {
      "command": "npx",
      "args": [
        "-y",
        "gen-understand"
      ],
      "env": {
        "UNDERSTAND_MCP_BINARY": "<UNDERSTAND_MCP_BINARY>",
        "UNDERSTAND_MCP_CACHE": "<UNDERSTAND_MCP_CACHE>"
      }
    }
  }
}

启动命令npx -y gen-understand

需要配置的环境变量

UNDERSTAND_MCP_BINARYPath of a local understand-mcp binary; skips the download, for offline machines

UNDERSTAND_MCP_CACHEFolder for the downloaded binary; defaults to the user cache folder

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmgen-understand0.2.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

gen-understand

gen-system 的 Understand 引擎，作为 MCP 服务提供。它为 AI Agent 提供代码库的解析结果：架构、符号、调用图、控制流图、效果、源代码，以及 gen-system 对每个例程的判断。这些结果并非由模型生成，而是由 Go、带有 copybook 的 COBOL、CA Gen、Java、TypeScript 和 Python 的确定性解析器生成。

该服务为只读服务，在本地运行，不会向任何地方发送数据。

使用方法

Claude Code

claude mcp add gen-understand -- npx -y gen-understand --root /path/to/your-repo

Codex（~/.codex/config.toml）

[mcp_servers.gen-understand]
command = "npx"
args = ["-y", "gen-understand", "--root", "/path/to/your-repo"]

Cursor（.cursor/mcp.json）

{
  "mcpServers": {
    "gen-understand": {
      "command": "npx",
      "args": ["-y", "gen-understand", "--root", "."]
    }
  }
}

工具

architecture、search_symbols、call_graph、control_flow、source、file_symbols、effects 和 beliefs。使用 --allow-corrections 时，还会提供 correct_belief。完整工具列表、标志和协议详情，请参阅 docs/mcp.md。

此软件包的工作方式

该服务是一个 Go 二进制文件。首次运行时，此软件包会从同版本的 gen-system 发布版本下载适用于你平台的二进制文件，对照该发布版本的 checksums.txt 检查其 SHA-256，并将其缓存起来。之后运行时会立即启动，并可离线工作。Linux、macOS 和 Windows 均提供 x64 和 arm64 版本。

变量	用途
`UNDERSTAND_MCP_BINARY`	本地 `understand-mcp` 二进制文件的路径。跳过下载，适用于离线机器
`UNDERSTAND_MCP_CACHE`	下载的二进制文件的存放文件夹。默认：用户缓存文件夹

无需 npm，也可以通过 Go 安装二进制文件：go install github.com/hpdkhoa/gen-system/generator/cmd/understand-mcp@latest。