用途:把代码库索引成分层图(tree-sitter AST → SQLite),通过 MCP 工具做依赖分析、路径追踪、API 影响、引用、实现、诊断与架构概览。适用于接手陌生代码库、重构函数/类前分析、理解调用流、快速查找符号。
主要能力:index_project 建立索引(幂等,自动跳过未变更文件);find_symbols 按名称查找;inspect_symbol 查看符号上下文;trace_paths 追踪依赖与调用(支持 mixed/calls、forward/reverse);find_references、find_implementations;trace_dataflow 分析数据流(需 source.anchor,可选 sink.anchor,锚点类型 param/local/return/property);api_impact 评估路由影响;analyze_architecture 查看架构与循环依赖;audit_workspace 查重复代码、热点、未用导出;diagnose_graph 检查图谱健康;analyze_changes 审查 diff;analyze_edit_region 评估编辑影响。语义工具只接受一个选择器:symbol_id、workspace_qualified_name、qualified_name 或 name+file。find_symbols 仅按名称发现,代码片段用 grep_search。结果被截断时应缩小 path 或改用 name+file。
使用方式:在 .mcp.json 配置 hex-graph MCP 服务器,command 为 node,args 为 {skills_repo}/mcp/hex-graph-mcp/server.mjs。输入 project_path 必填,command 可选(index、search、symbol、paths、refs、arch)。优先用 hex-graph 处理符号身份、引用、实现、架构、数据流、编辑影响;本地读取可用 hex-line。MCP 不可用时退回 Glob/Grep/Read/Bash 并说明置信度下降。
支持语言:JavaScript、TypeScript/TSX 语义覆盖最强;Python、C#、PHP 支持工作区级定义、调用、导入等,安装 provider 后可选精确覆盖。
限制:MCP 不可用或未索引时需手动回退;部分语言精确覆盖依赖 provider;资料未提供收费、价格、平台与效果信息。