Code Health Suite
16 analysis engines, 28 MCP tools for Python code quality. Zero external dependencies.
Quick Start
As MCP Server (Claude Desktop / Claude Code)
{
"mcpServers": {
"code-health": {
"command": "code-health-suite"
}
}
}
Install from PyPI
pip install code-health-suite
Or with uvx (no install needed):
uvx code-health-suite
Install from GitHub
pip install git+https://github.com/nge/code-health-suite
Tools
| # | Tool | Engine | What it does |
|---|---|---|---|
| 1 | analyze_complexity | complexity | Per-function CC, cognitive complexity, nesting, grades |
| 2 | get_complexity_score | complexity | Project health score 0-100 |
| 3 | find_dead_code | dead-code | Unused imports, functions, variables, arguments |
| 4 | security_scan | security | OWASP vulns, CWE-mapped findings |
| 5 | get_security_score | security | Security health score 0-100 |
| 6 | analyze_imports | import-graph | Import dependency graph, circular deps |
| 7 | get_import_health | import-graph | Import architecture score 0-100 |
| 8 | find_clones | clone-detect | Type-1/2/3 code clone detection |
| 9 | analyze_test_quality | test-quality | Test suite metrics, anti-patterns |
| 10 | full_health_check | all engines | Combined report with overall grade |
| 11 | find_hotspots | hotspot | Files with high git churn AND high complexity |
| 12 | get_hotspot_score | hotspot | Project churn-complexity score |
| 13 | audit_dependencies | dep-audit | Outdated/vulnerable dependency check |
| 14 | analyze_change_impact | change-impact | Blast radius of file changes |
| 15 | get_coupling_score | change-impact | Module coupling metrics |
| 16 | analyze_types | type-audit | Type annotation coverage |
| 17 | get_type_score | type-audit | Type coverage score 0-100 |
| 18 | audit_env | env-audit | Environment variable audit |
| 19 | audit_git_commits | git-audit | Commit quality audit (security + complexity) |
| 20 | get_git_audit_score | git-audit | Git commit health score |
Requirements
- Python 3.10+
- Zero external dependencies (stdlib only)
License
MIT