MCP 集成

sentrux 以 MCP 服务器的方式运行，让你的 AI 代理实时获取架构健康状况。

配置

Claude Code

/plugin marketplace add sentrux/sentrux
/plugin install sentrux

Cursor / Windsurf / OpenCode / 任何 MCP 客户端

将以下内容添加到你的 MCP 配置中：

{
  "mcpServers": {
    "sentrux": {
      "command": "sentrux",
      "args": ["--mcp"]
    }
  }
}

代理工作流

Agent: scan("/Users/me/myproject")
  → { quality_signal: 7342, files: 139, bottleneck: "modularity" }

Agent: session_start()
  → { status: "Baseline saved", quality_signal: 7342 }

  ... agent writes 500 lines of code ...

Agent: session_end()
  → { pass: false, signal_before: 7342, signal_after: 6891,
      summary: "Quality degraded during this session" }

代理能够看到自身的影响。如果质量下降，它会立即知晓。

可用工具

工具	用途
scan	扫描目录，获取质量信号和文件列表
health	详细的根因分解与诊断信息
session_start	在代理会话开始前保存基线
session_end	与基线对比，检测质量退化
rescan	变更后重新扫描（比全量扫描更快）
check_rules	根据 .sentrux/rules.toml 进行规则校验
git_stats	Git 历史分析——热点、变更频率、巴士因子
dsm	设计结构矩阵（依赖矩阵）
test_gaps	查找未被测试覆盖的代码路径

MCP 响应示例

{
  "quality_signal": 7342,
  "bottleneck": "modularity",
  "root_causes": {
    "modularity":  { "score": 6700, "raw": 0.45 },
    "acyclicity":  { "score": 10000, "raw": 0 },
    "depth":       { "score": 10000, "raw": 4 },
    "equality":    { "score": 6100, "raw": 0.35 },
    "redundancy":  { "score": 8800, "raw": 0.12 }
  }
}

代理会针对得分最低的根因进行优化，以每次变更获取最大改善。

反馈回路

sentrux (传感器) → quality_signal → AI 代理 (控制器)
    → 代码变更 (执行器) → 代码库 (系统) → sentrux

这是经典的控制论（Wiener 1948）。这个回路会自然收敛——每次迭代中代理修复最大的瓶颈，改善逐渐变小，最终达到收敛。