企业官网建设流程全解析

让Claude Code接入sentrux MCP服务器：AI Agent自动感知架构劣化的完整配置教程

【免费下载链接】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

sentrux是一款纯 Rust 编写的实时架构传感器，它内置MCP服务器，能让 Claude Code 等 AI Agent 直接读取项目的架构健康度。本教程带你完成完整配置：安装传感器 → 接入 Claude Code → 建立会话门禁，让 AI 在每次会话前后自动感知架构劣化，代码质量不再靠猜。

为什么要给AI Agent装一个"传感器"？

用 Claude Code 写代码时，你经常会看到一串Modified src/foo.rs——但你看不到这个文件在依赖图里的位置，也看不到它刚刚制造了一个循环依赖。AI 生成的代码越快，没有传感器时架构腐化得也越快。

sentrux 的做法很简单：

• 扫描：解析整个项目，计算一个 0–10000 的质量信号（Quality Signal）
• 诊断：把分数拆解为模块化、无环性、深度、均衡性、冗余度 5 个根因
• 门禁：会话前存基线、会话后对比，劣化立刻报警

全部分析在本地完成，零网络调用。下面是它的实时界面：Agent 改动文件时，对应区块会发光，依赖关系以边缘线呈现。

第一步：安装sentrux（30秒完成）

sentrux 是单二进制文件，无运行时依赖，通过 tree-sitter 插件支持52 种语言（Rust、Python、Go、TypeScript、Java……）。

# macOS brew install sentrux/tap/sentrux # Linux curl -fsSL https://raw.githubusercontent.com/sentrux/sentrux/main/install.sh | sh # Windows：从 Releases 下载 sentrux.exe

验证安装：

sentrux check . # 在当前项目跑一次规则检查（CI友好，退出码0或1）

💡 如果没有现成的二进制，也可以从源码构建：git clone https://gitcode.com/gh_mirrors/se/sentrux然后cargo build --release。

第二步：Claude Code接入sentrux MCP服务器（插件方式）

在 Claude Code 里输入两条命令，即可完成接入：

/plugin marketplace add sentrux/sentrux /plugin install sentrux

插件清单定义在仓库的 marketplace.json 中，它会把 sentrux 注册为 MCP 服务器，并附带一个scan技能——教会 Agent 何时该扫描、何时该跑会话门禁，技能说明见 SKILL.md。

第三步：其他MCP客户端手动配置

Cursor、Windsurf、OpenCode 或任何 MCP 客户端，只需在 MCP 配置里加一段：

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

MCP 服务器通过 stdin/stdout 走 JSON-RPC 通信，实现了initialize、tools/list、tools/call三个核心方法，核心实现见 mod.rs，工具处理逻辑在 handlers.rs。

9个MCP工具：Agent能感知到什么？

接入后，Agent 可以调用 9 个工具，覆盖"体检 → 门禁 → 深度分析"的完整链路：

推荐的Agent工作流：scan → 基线 → 门禁

sentrux 设计的标准闭环只有 3 步，可以让 Agent 自己执行（把这段写进你的 CLAUDE.md 提示词即可）：

Agent: scan("/path/to/project") → { quality_signal: 7342, files: 139 } Agent: session_start() → { status: "Baseline saved", quality_signal: 7342 } ... Agent 写了几百行代码 ... Agent: session_end() → { pass: false, signal_before: 7342, signal_after: 6891, summary: "Quality degraded" }

看到pass: false，Agent 就知道这一轮把架构改坏了——它会带着health返回的瓶颈信息（比如bottleneck: "modularity"）自动回头修复，而不是带着劣化直接提交。

这就是"闭环"：sentrux 是传感器，你的规则是规格，Agent 是执行器。

进阶：用规则文件给Agent划"边界"

在项目的.sentrux/rules.toml里声明架构约束，check_rules工具（以及sentrux check命令）就会强制执行。仓库自带的示例 rules.toml 展示了典型写法：

[constraints] max_cycles = 0 # 禁止循环依赖 max_cc = 25 # 函数圈复杂度上限 [[layers]] name = "core" paths = ["src/core/*"] order = 0 # 高层只能依赖低层 [[boundaries]] from = "src/renderer/*" to = "src/analysis/*" reason = "Renderer must not depend on analysis directly"

把check_rules加进 CI，架构约束就从"口头约定"变成了机器可执行的门禁。

常见问题

Q：免费版有什么限制？核心工具全部免费。免费版会截断部分明细（只返回 Top-3 摘要、最多 3 条规则），Pro 版解锁完整诊断列表与无限量规则。

Q：代码会被上传到网络吗？不会。所有解析与指标计算都发生在本地进程内，MCP 服务器零网络调用。

Q：项目语言不在支持列表里怎么办？sentrux 的语言知识全部外置在插件里（plugins/ 目录下的plugin.toml+tags.scm查询文件），可以用sentrux plugin add <name>安装新语言插件，甚至用sentrux plugin init my-lang自建一个。

小结

三步接入 Claude Code：安装 sentrux →/plugin install sentrux→ 让 Agent 按scan → session_start → session_end循环工作。从此每一次 AI 会话都有架构分数兜底，劣化在提交的瞬间就被看见——这才是把 AI 的速度变成生产力，而不是债务。

【免费下载链接】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