tomevault-io Python Code Quality Analysis with pyscn MCP
Use the pyscn MCP tools for Python code quality analysis.
Available Tools
| Tool | Purpose |
|---|---|
get_health_score |
Overall code health score (0-100) with grade |
analyze_code |
Comprehensive analysis (complexity, dead code, clones, coupling, deps) |
check_complexity |
Cyclomatic complexity of functions |
detect_clones |
Duplicate code detection |
find_dead_code |
Unreachable code detection |
check_coupling |
Class coupling (CBO) metrics |
Tool Selection Guide
| User Request | Tool |
|---|---|
| "How healthy is this code?" | get_health_score |
| "Analyze code quality" | analyze_code |
| "Find complex functions" | check_complexity |
| "Find duplicate code" | detect_clones |
| "Find dead code" | find_dead_code |
| "Check class coupling" | check_coupling |
Common Parameters
path(required): Path to Python file or directoryrecursive(analyze_code): Recursively analyze directories (default: true)analyses(analyze_code): Array of analyses to run -complexity,dead_code,clone,cbo,deps
Examples
Quick Health Check
Use get_health_score for a quick overview:
- Returns score 0-100 with letter grade (A-F)
- Category breakdowns for maintainability, reliability, etc.
Detailed Analysis
Use analyze_code with specific analyses:
analyses: ["complexity"]- Only complexityanalyses: ["clone"]- Only duplicatesanalyses: ["dead_code"]- Only dead codeanalyses: ["complexity", "dead_code"]- Multiple
Complexity Thresholds
Use check_complexity with:
min_complexity: Minimum to report (default: 1)max_complexity: Maximum allowed (default: 0 = no limit)
Clone Detection
Use detect_clones with:
similarity_threshold: 0.0-1.0 (default: 0.8)min_lines: Minimum lines to consider (default: 5)
Always explain results and suggest improvements based on findings.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.