pyscn MCP server
io.github.ludo-technologies/pyscn·v1.33.1·1.1k starsPython code analysis for AI agents: complexity, dead code, clones, coupling, and a health score.
not scanned yet
1.1k stars275 downloads/wk
Reviews
Write oneNobody has reviewed pyscn yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
pyscn tools
No tool declarations could be read from the package source. They show once the server is installed.
How pyscn compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 94/100
- higher than 96% of 48,255 servers
- GitHub stars
- 1,088
- more than 95% of 28,688 servers
- Downloads a week
- 275
- more than 80% of 12,191 servers with a package
Release history: 7 versions in the registry since 2026-09-15, latest 2026-10-29, typically one every 8 days.
Install pyscn in Claude Code, Cursor or VS Code
claude mcp add pyscn -- uvx pyscn-mcp
What the publisher says
From the pyscn repository's README, as published. We do not edit it. Read it on GitHub
English | 日本語 | 简体中文 | Français
Code quality analysis for Python in the age of AI coding.
Building with Cursor, Claude, or ChatGPT? pyscn keeps AI-generated code maintainable with structural analysis.
Track your codebase's health every week with Polyscan. Automatically monitor complexity, duplication, and dead code, with changes delivered as a GitHub Issue. Set up weekly monitoring → · Free for public repositories
Quick Start
# Run analysis without installation
uvx pyscn@latest analyze .
# or
pipx run pyscn analyze .Demo
Features
One command scores your whole codebase (0-100 with an A-F grade) and generates an HTML report that shows what to fix first.
pyscn looks at your code from five angles:
- 🧹 Dead code - unreachable code you can safely delete
- 📋 Duplicate code - copy-pasted and structurally similar code worth merging (Type 1-4 clone detection)
- 🌀 Complexity - functions and executable class suites that are hard to read and test (cyclomatic and cognitive complexity)
- 🔥 Module and directory hotspots - per-file quality and per-directory complexity rollups for prioritizing refactors
- 🏗️ Architecture - circular imports, layer rule violations (clean / layered / hexagonal / MVC presets), and auto-detected module communities that reveal how your code is actually structured
- 🧩 Class design - classes that do too much or depend on too much (CBO coupling, LCOM4 cohesion)
100,000+ lines/sec • Built with Go + tree-sitter
Working with other languages? pyscn is part of polyscan, code quality analyzers for JavaScript/TypeScript and more.
AI Agent Integration
pyscn ships Agent Skills that teach AI coding agents when and how to run each analysis: health checks, refactoring, architecture review, and CI-friendly reports.
Agent Skills (Recommended)
uvx add-skills ludo-technologies/pyscnThis installs the Skills into your project. They work with Claude Code, Cursor, Codex, Gemini CLI, and many other agents (add --agent cursor etc. to target one, --global for all projects).
Then just ask your agent:
- "Analyze the code quality of the app/ directory"
- "Find duplicate code and help me refactor it"
- "Show me complex code and help me simplify it"
MCP Server (Optional)
For tighter integration, the bundled pyscn-mcp server exposes the same analyses as MCP tools to Claude Code, Cursor, ChatGPT, and other MCP clients.
Claude Code plugin (sets up the MCP server and the Skills together):
claude plugin marketplace add ludo-technologies/pyscn
claude plugin install pyscn-mcp@pyscn-marketplaceManual setup for Claude Code:
claude mcp add pyscn-mcp uvx -- pyscn-mcpShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
pyscn: common questions
- Is pyscn MCP server safe?
- Yes, by our scan: it is graded A (94/100). Read the pyscn safety report
- How do I install pyscn?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does pyscn need an API key?
- No secret keys are declared. It reads 1 setting from the environment.
- Is pyscn maintained?
- The last commit was 32 days ago (2026-10-03). The latest release is v1.33.1.
- How does pyscn compare with other MCP servers?
- safety score 94/100 (higher than 96% of 48,255 servers); github stars 1,088 (more than 95% of 28,688 servers); downloads a week 275 (more than 80% of 12,191 servers with a package). Full comparison.