Summary
A comprehensive Python code quality toolkit that plugs 16 analysis engines into Claude through 28 MCP tools. You get complexity analysis with cyclomatic and cognitive metrics, dead code detection for unused imports and functions, OWASP security scans with CWE mapping, import graph analysis for circular dependencies, and clone detection. It also includes test quality metrics, git hotspot analysis that combines churn with complexity, dependency auditing, change impact analysis, type annotation coverage, and commit quality audits. Everything runs on Python's standard library with zero external dependencies. Reach for this when you need a complete code health audit without juggling multiple linting tools, or when Claude needs to assess technical debt across a Python codebase. Each engine returns a 0-100 health score.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →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
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →