
Code Health Suite
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.
- tools
- 20
- transport
- STDIO
- last updated
- Mar 19, 2026
Tools
20 toolsPublic tool metadata for what this MCP can expose to an agent.
analyze_complexityPer-function CC, cognitive complexity, nesting, grades
Per-function CC, cognitive complexity, nesting, grades
No parameter schema in public metadata yet.
get_complexity_scoreProject health score 0-100
Project health score 0-100
No parameter schema in public metadata yet.
find_dead_codeUnused imports, functions, variables, arguments
Unused imports, functions, variables, arguments
No parameter schema in public metadata yet.
security_scanOWASP vulns, CWE-mapped findings
OWASP vulns, CWE-mapped findings
No parameter schema in public metadata yet.
get_security_scoreSecurity health score 0-100
Security health score 0-100
No parameter schema in public metadata yet.
analyze_importsImport dependency graph, circular deps
Import dependency graph, circular deps
No parameter schema in public metadata yet.
get_import_healthImport architecture score 0-100
Import architecture score 0-100
No parameter schema in public metadata yet.
find_clonesType-1/2/3 code clone detection
Type-1/2/3 code clone detection
No parameter schema in public metadata yet.
analyze_test_qualityTest suite metrics, anti-patterns
Test suite metrics, anti-patterns
No parameter schema in public metadata yet.
full_health_checkCombined report with overall grade
Combined report with overall grade
No parameter schema in public metadata yet.
find_hotspotsFiles with high git churn AND high complexity
Files with high git churn AND high complexity
No parameter schema in public metadata yet.
get_hotspot_scoreProject churn-complexity score
Project churn-complexity score
No parameter schema in public metadata yet.
audit_dependenciesOutdated/vulnerable dependency check
Outdated/vulnerable dependency check
No parameter schema in public metadata yet.
analyze_change_impactBlast radius of file changes
Blast radius of file changes
No parameter schema in public metadata yet.
get_coupling_scoreModule coupling metrics
Module coupling metrics
No parameter schema in public metadata yet.
analyze_typesType annotation coverage
Type annotation coverage
No parameter schema in public metadata yet.
get_type_scoreType coverage score 0-100
Type coverage score 0-100
No parameter schema in public metadata yet.
audit_envEnvironment variable audit
Environment variable audit
No parameter schema in public metadata yet.
audit_git_commitsCommit quality audit (security + complexity)
Commit quality audit (security + complexity)
No parameter schema in public metadata yet.
get_git_audit_scoreGit commit health score
Git commit health score
No parameter schema in public metadata yet.
Sponsors
Readme
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
Details
- Repository
- github.com/neogeweb3/code-health-suite
- Package
code-health-suite- Transport
- STDIO
- Registry
- MCP registry, active