neogeweb3 avatar

Code Health Suite

neogeweb3/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 tools

Public 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


View the full README on GitHub

Details

Repository
github.com/neogeweb3/code-health-suite
Package
code-health-suite
Transport
STDIO
Registry
MCP registry, active