# Pyscn MCP

> Analyze Python code quality using MCP tools - complexity, clones, dead code, coupling. Use when user asks about code quality, refactoring, maintainability, duplicates, or technical debt. Use when this capability is needed.

- Skill: `tomevault-io/pyscn-mcp` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/pyscn-mcp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/pyscn-mcp/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/pyscn-mcp

---


# 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 directory
- `recursive` (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 complexity
- `analyses: ["clone"]` - Only duplicates
- `analyses: ["dead_code"]` - Only dead code
- `analyses: ["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](https://tomevault.io/claim/ludo-technologies) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->