16 analysis engines, 28 MCP tools for Python code quality. Zero external dependencies.
Project description
Code Health Suite
13 analysis engines, 22 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
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file code_health_suite-0.8.0.tar.gz.
File metadata
- Download URL: code_health_suite-0.8.0.tar.gz
- Upload date:
- Size: 229.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
25ffd76bd769d89e110f7952b0d1809d6c3361f57975b28e3ba7f41dd87ff3d6
|
|
| MD5 |
84e982ad1af0b4bfac4708d9ce5d6358
|
|
| BLAKE2b-256 |
3d203021eb02fd616655d6d210fab6ddb146aca1b54ea22a728d3ccd30ca8ef5
|
Provenance
The following attestation bundles were made for code_health_suite-0.8.0.tar.gz:
Publisher:
pypi-publish.yml on neogeweb3/code-health-suite
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
code_health_suite-0.8.0.tar.gz -
Subject digest:
25ffd76bd769d89e110f7952b0d1809d6c3361f57975b28e3ba7f41dd87ff3d6 - Sigstore transparency entry: 1128353954
- Sigstore integration time:
-
Permalink:
neogeweb3/code-health-suite@313a80b47d769c86e43104baec961c50928d6d28 -
Branch / Tag:
refs/tags/v0.8.0 - Owner: https://github.com/neogeweb3
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-publish.yml@313a80b47d769c86e43104baec961c50928d6d28 -
Trigger Event:
push
-
Statement type:
File details
Details for the file code_health_suite-0.8.0-py3-none-any.whl.
File metadata
- Download URL: code_health_suite-0.8.0-py3-none-any.whl
- Upload date:
- Size: 130.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
de6b4e1c9acd5307909c8ffcb91a265a85045dc409533b5479a0443b3703ab9d
|
|
| MD5 |
29f500ef7072fe4c90757fbcda179ee9
|
|
| BLAKE2b-256 |
324e67fc353f93e53a12220c7ae7790c89d8ba0019e1c656b3649d871248cf33
|
Provenance
The following attestation bundles were made for code_health_suite-0.8.0-py3-none-any.whl:
Publisher:
pypi-publish.yml on neogeweb3/code-health-suite
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
code_health_suite-0.8.0-py3-none-any.whl -
Subject digest:
de6b4e1c9acd5307909c8ffcb91a265a85045dc409533b5479a0443b3703ab9d - Sigstore transparency entry: 1128354023
- Sigstore integration time:
-
Permalink:
neogeweb3/code-health-suite@313a80b47d769c86e43104baec961c50928d6d28 -
Branch / Tag:
refs/tags/v0.8.0 - Owner: https://github.com/neogeweb3
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-publish.yml@313a80b47d769c86e43104baec961c50928d6d28 -
Trigger Event:
push
-
Statement type: