| name | codehealth-mcp |
| description | Code health assessment qua CodeScene MCP — đánh giá structural maintainability, detect regression trước commit/PR. Score 1-10, tích hợp Claude Code. |
| origin | ECC |
| user-invocable | true |
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
export CS_ACCESS_TOKEN=your-codescene-token
{
"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
