sentrux MCP九大工具API详解：scan、health、evolution、dsm、test_gaps完整参考手册

sentrux MCP九大工具API详解scan、health、evolution、dsm、test_gaps完整参考手册【免费下载链接】sentruxReal-time architectural sensor that helps AI agents close the feedback loop, enabling recursive self-improvement of code quality. Pure Rust.项目地址: https://gitcode.com/gh_mirrors/se/sentruxsentrux 是一个纯 Rust 编写的实时架构传感器Architectural Sensor通过 MCP 协议把代码结构健康度直接喂给 AI Agent帮助其形成扫描 → 改进 → 复扫的反馈闭环。本文详解 sentrux MCP 服务器的九大工具 APIscan、health、session_start、session_end、rescan、check_rules、evolution、dsm、test_gaps并给出典型调用流程方便你把架构传感器快速接入 Claude Code、Cursor 等 MCP 客户端。一、sentrux MCP服务器是什么MCPModel Context Protocol服务器让 AI Agent 可以像调用本地函数一样调用分析工具。sentrux 通过sentrux --mcp命令启动服务器从 stdin 读取 JSON-RPC 请求、向 stdout 返回结果所有分析都在本地完成零网络调用。核心实现位于 sentrux-core/src/app/mcp_server/mod.rs工具注册所有工具以ToolDef形式注册在 registry.rsschema、handler、授权等级集中定义单一注册点统一调度dispatch()统一处理许可证校验、缓存失效与执行Agent 看到的每个工具返回结构一致状态缓存McpState缓存扫描快照、健康报告避免重复扫描同一目录接入方式只需在 MCP 客户端配置中加一段 JSON见 claude-plugin/.mcp.json{ mcpServers: { sentrux: { command: sentrux, args: [--mcp] } } }二、九大工具速览工具参数核心返回用途一句话scanpathquality_signal、files、lines全量扫描一切分析的起点health无质量信号 5大根因得分一个分数告诉你架构哪块最弱session_start无基线快照会话前存档当前质量session_end无前后 diff、pass/fail会话后检测质量是否退化rescan无新质量信号拾取上次扫描后的文件变更check_rules无规则通过/违规列表校验自定义架构约束evolution(git_stats)dayschurn、热点、bus factorGit 历史维度的风险画像dsmformat依赖矩阵统计分层是否干净、有没有倒挂test_gapslimit测试覆盖缺口找出零测试的高风险文件 注意源码中 evolution 工具实际注册名为git_stats见 handlers_evo.rs文档与 README 常以 evolution 称呼它。三、基础工具scan 与 rescanscan必须第一步调用scan是唯一带必填参数的工具——传入项目目录的绝对路径。它触发全量扫描并返回quality_signal0–10000 的连续质量信号几何均值越大越好files/lines/import_edges规模与依赖边数实现见 handlers.rs 的 scan_def()。所有后续工具都依赖scan写入的缓存状态未扫描直接调用会收到 No scan data. Call scan first. 的提示。rescan轻量刷新改完代码后不必重新scan直接调rescan即可基于上次目录重新计算指标返回新的quality_signal与文件数适合在 Agent 迭代循环中高频使用。四、health一个分数五大根因health是 sentrux 的真分数工具不返回一堆散落指标而是给一个质量信号 瓶颈定位。返回结构quality_signal综合得分bottleneck最弱根因如modularity告诉 Agent 该往哪使劲root_causesmodularity模块化、acyclicity无环性、depth深度、equality均衡性、redundancy冗余五项的得分与原始值total_import_edges/cross_module_edges耦合规模五项根因的设计细节可参考 docs/quality-signal-design.md。五、会话治理session_start / session_end这是让 AI Agent 形成闭环的关键组合拳工作流在 README.zh-CN.md 中有完整示例scan后调用session_start把当前健康指标存为基线Agent 自由写码调用session_end自动复扫并对比返回pass、signal_before/after、signal_delta、coupling_change、cycles_change与violations一句话总结结果Quality degraded during this session还是Quality stable or improvedAgent 据此决定是继续还是回头修复。六、check_rules把架构决策写成约束在项目中放一个.sentrux/rules.toml即可声明约束最大环数、耦合等级上限、禁上帝文件、分层顺序、禁止的依赖边界等check_rules会返回pass、rules_checked、violation_count及逐条违规详情规则名、严重级别、涉及文件。免费版最多检查 3 条规则超出部分会返回truncated提示Pro 版无限制。CLI 等价命令为sentrux check .适合放进 CI。七、evolutiongit_statsGit 历史风险画像基于 git 历史分析可选参数days控制回溯窗口默认 90 天。返回commits_analyzed/files_with_churn改动量single_author_ratio单人作者占比 → 换算bus_factor_solo_files巴士因子风险coupling_pairs_found变更耦合总是一起改的文件对hotspot_countchurn × 复杂度交叉得出的热点数它是原始数据而非分数适合回答哪里又热又复杂、谁的知识在单点。Pro 版额外返回top_hotspots文件级明细。八、dsm依赖矩阵一眼看出倒挂dsmDesign Structure Matrix设计结构矩阵输出 NxN 依赖矩阵的统计视图可选参数formatstats默认 /text输出 ASCII 矩阵。核心字段above_diagonal/below_diagonal上三角边越多说明下层依赖上层的倒挂越多interpretation直接给出人话结论如 Clean layering: all dependencies flow downwardclusters/level_breaks自然聚簇与分层断点对应指标实现位于 sentrux-core/src/metrics/dsm/mod.rs。九、test_gaps零测试的高危文件test_gaps交叉比对测试文件、import 图与复杂度返回coverage_score、coverage_ratio、untested等汇总Pro 版返回riskiest_untested按风险排序的 Top-Nlimit默认 20与test_files_detail每个测试文件实际覆盖了谁。对 Agent 来说这是下一步该补哪些测试的直接答案。十、典型调用顺序清单scan(path) # 建立快照与质量信号 ↓ session_start() # 存档基线 ↓ Agent 写码 session_end() # 复扫对比检测退化 ↓ 如需深入定位 health / dsm / git_stats / test_gaps # 按 bottleneck 深挖 ↓ check_rules() # 校验架构约束收尾配套技能文件 claude-plugin/skills/scan/SKILL.md 中也内置了这套扫描→健康度→会话治理的推荐顺序可直接供 Claude Code 参考。写在最后sentrux 的 MCP 九大工具遵循一个设计哲学scan 建基线health 给方向会话工具管闭环evolution / dsm / test_gaps 做深挖check_rules 守边界。把sentrux --mcp接入你的 Agent等于给 AI 装上了架构传感器——它不再只看到Modified src/foo.rs这样的流水账而是真正知道每一次改动让质量信号涨了还是跌了。想从源码构建克隆仓库后执行cargo build --release即可仓库地址https://gitcode.com/gh_mirrors/se/sentrux 。【免费下载链接】sentruxReal-time architectural sensor that helps AI agents close the feedback loop, enabling recursive self-improvement of code quality. Pure Rust.项目地址: https://gitcode.com/gh_mirrors/se/sentrux创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考