sentrux MCP九大工具API详解：scan、health、evolution、dsm、test

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），仅供参考

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

相关推荐

JeeWMS开源WMS系统部署与二次开发实战指南

CTF夺旗赛新手入门：Web、逆向、盲注与Misc实战指南

【共创稿事节】鸿蒙HarmonyOS7.0端侧AI新能力-图像超分 · 画质增强：基于 Core Vision Kit 的端侧 4 倍高清重建

更多资讯

Windows 微博图床工具与 picgo VSCode 插件版：TaoToken 统一 Key 配置实战

VPC、子网、虚拟网卡与ACL详解：云上网络入门地图

Git Merge与Rebase最全对比：场景选型、冲突解决与避坑指南

如何验证分布式图数据库的一致性：HydraDB的Jepsen测试与形式化验证实践

【Codex】深入拆解 OpenAI 开源 AI 编程助手：从 GitHub 仓库到 TaoToken 统一 Key 接入

ntko控件部署与调用全攻略：从ActiveX到跨浏览器插件的OA集成实践

今日更新

BunnyScholar硕士论文跨章节检查：长文档双栏如何梳理因果链

维普标红教育学SEM量表怎么办：助研君修改与RMSEA指标复核

知网标红有限元仿真与网格划分怎么办：助研君按字修改与参数复核

本周精选

深入解析Transformer多头注意力机制与工程优化

OpenClaw 的 Skills 跑学习任务，模型通道改到 TaoToken 通道行不行？

ChatGPT报错Oops, an error occurred! 全链路排查指南

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？