yanacuti1121 CodeHealth MCP — Structural Maintainability Assessment
Tích hợp CodeScene vào Claude Code để đánh giá code health trước khi sửa/commit.
Setup
# Set access token
export CS_ACCESS_TOKEN=your-codescene-token
# Thêm vào mcp-configs/mcp-servers.json
{
"codescene": {
"command": "npx",
"args": ["@codescene/codehealth-mcp"],
"env": { "CS_ACCESS_TOKEN": "${CS_ACCESS_TOKEN}" }
}
}
Không cần credentials trong repo. Token chỉ qua env var.
4 tools có sẵn
| Tool | Dùng khi |
|---|---|
code_health_review |
Trước khi sửa code — xem baseline |
code_health_score |
Sau khi sửa — detect regression |
pre_commit_code_health_safeguard |
Trước khi commit — block nếu score giảm |
analyze_change_set |
Trước khi mở PR — assess toàn branch |
Score scale (1–10)
| Score | Màu | Ý nghĩa |
|---|---|---|
| 9.0–10.0 | 🟢 Green | Healthy — safe to extend |
| 4.0–8.9 | 🟡 Yellow | Tech debt — tránh refactor lớn |
| 1.0–3.9 | 🔴 Red | Severe debt — giới hạn scope |
Workflow chuẩn
1. code_health_review # Xem baseline trước khi sửa
2. Sửa code (targeted)
3. code_health_score # Check sau khi sửa
4. Lặp lại cho đến khi score không giảm
5. pre_commit_code_health_safeguard # Trước commit
6. analyze_change_set # Trước khi mở PR
Không mark "done" nếu score regression.
Khi MCP không khả dụng
Skip check và tiếp tục — chỉ cần human approval tường minh.
Source
@codescene/codehealth-mcp · https://codescene.com