AI 写完代码谁来「体检」？Code Health MCP 让 Claude Code 用分数说话

每次看到 AI 帮你「顺手重构」的代码，心里是不是有点慌？改是改完了，可谁来保证代码没有越改越烂？

CodeScene 团队做了一件特别对的事——他们把代码健康度分析做成了一个 MCP 服务，ECC 把它封装成了 Code Health MCP 这个 Skill，装进 Claude Code 里，让 AI 在动手之前先「体检」，动手之后再「复检」，用分数说话，而不是靠感觉。

这玩意儿能干什么？

装好之后，Claude Code 会多出 4 个工具，都是围绕「代码健康度分数」运转的：

• code_health_review：编辑文件之前，先扫描一遍，给出 1-10 的健康分，同时列出具体的技术债和代码异味（code smells）。
• code_health_score：改完一轮之后，快速算出新的分数，和基准线对比——分数掉了，立刻回退，不能假装没发生。
• pre_commit_code_health_safeguard：git commit 之前自动跑，分数回归就 block 掉这次提交，逼你先把问题修掉再推进。
• analyze_change_set：开 PR 之前分析整个变更集，给出全局的健康度回归报告。

分数怎么看？

评分体系很直接：

• 9.0-10.0（绿色）：健康，随意扩展，但仍然推荐纵向切片式改动。
• 4.0-8.9（黄色）：有债务，小心驾驶，不要做大范围重构。
• 1.0-3.9（红色）：债务严重，只做最小范围改动。

一个典型工作流是这样的：拿到任务 → 先 review 目标文件（记下基准分）→ 做最小改动 → 每次改完跑 score → 分数跌了就先修再继续 → commit 前 safeguard → PR 前 analyze_change_set。

用起来麻烦吗？

不麻烦。配置分两步：

第一步，把 MCP 服务接进 Claude Code，在 ~/.claude.json 的 mcpServers 里加一个入口，然后去 CodeScene 官网申请一个免费的个人 Access Token（不需要付费订阅，standalone 模式足够用那 4 个工具）。

第二步，在项目根目录的 AGENTS.md 或 CLAUDE.md 里粘贴官方提供的 Code Health 使用规范，之后每次 Claude Code 启动都会自动遵循这套流程，不需要记住任何指令。

谁适合用？

如果你在用 Claude Code 写生产级代码，或者团队里有人用 AI 编程工具做实质性开发，这个 Skill 能堵住一个很大的盲区——AI 写代码很快，但没法自动感知自己的改动有没有让代码库变烂。Code Health MCP 补的就是这一环。

安全方面也不需要太担心：工具只分析本地仓库里的文件路径和 git 状态，不上传代码，不碰 token 之外的东西。离线模式也能跑，不依赖 CodeScene 平台。

上游 CodeScene MCP Server（Rust 编写）目前在 GitHub 有 58 颗星，活跃维护中。

GitHub：https://github.com/affaan-m/ECC/tree/main/skills/codehealth-mcp

GitHub: https://github.com/affaan-m/ECC/tree/main/skills/codehealth-mcp