code-quality-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
code-quality-mcp
Stop asking your LLM if your Python is clean. Let it actually check.
An MCP server that gives Claude, Cursor, VS Code (or any MCP-compatible client) a real, deterministic view of your Python code quality — powered by the tools you already trust: flake8, mypy, McCabe, and vulture.
No more "looks good to me" from an LLM that never ran a linter. This is ground truth.
Why
LLMs hallucinate code reviews. They miss style violations, invent complexity numbers, and confidently declare your dead code "actively used."
code-quality-mcp plugs the gap: it runs the canonical Python quality tools and hands the LLM a clean, structured report. The model stops guessing and starts citing.
It also ships with a hard instruction baked into the server: never modify, refactor, or fix your code unless you explicitly ask. It reports. You decide.
Related MCP server: mcp-server-analyzer
What it gives you
Tool | What it checks | MCP function |
flake8 | PEP8 style, line length, unused imports |
|
McCabe | Cyclomatic complexity per function |
|
vulture | Dead code, unused variables and functions |
|
mypy | Static type errors |
|
All-in-one | flake8 + McCabe + vulture, parallel |
|
Snippet mode | Paste raw source, no file needed |
|
Reports come back as markdown tables — readable for you, parseable for the model.
Install
git clone https://github.com/Javier-Morenosa/code-quality-mcp.git
cd code-quality-mcp
pip install -e .Requires Python 3.10+.
Wire it up
Cursor
Add to your Cursor MCP settings (or copy cursor_mcp.json):
{
"mcpServers": {
"code-quality": {
"command": "python",
"args": ["-m", "code_quality_mcp.server"],
"env": {
"PYTHONPATH": "C:/path/to/code-quality-mcp/src"
}
}
}
}VS Code
See vscode_mcp.json for a ready-to-use config.
Claude Code
claude mcp add code-quality -- python -m code_quality_mcp.serverUse it
Once the server is wired up, just talk to your LLM:
"Run a full quality analysis on
src/my_module.py."
"Is there dead code in this project?"
"Which functions are too complex?"
The model will call the right tools, get real output from real linters, and give you a report grounded in facts — not vibes.
Pro tip
Call set_workspace once at the start of a session to point the server at your project root. After that, you can pass relative paths and everything Just Works.
What it will NOT do
By design, this server is read-only. It will not:
Edit your files
Refactor your code
Auto-fix style issues
Suggest changes unless you explicitly ask for them
If you want fixes, run black, ruff --fix, or ask your LLM directly. This server's job is to tell the truth about your code, nothing more.
Roadmap
ruffbackend as a faster drop-in for flake8Per-file complexity heatmap
Configurable rule sets via
pyproject.toml
License
MIT. Use it, ship it, fork it.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
30+ deterministic dev and delivery tools: linting, metrics, diagrams, model advice, AI-text checks.
Evidence-backed architecture-quality analysis for Python agent applications.
Checks AI-written code for leaked keys and made-up packages, on your machine. Never uploads code.
Proves AI-generated Python does what you asked: lint, types, security, sandbox run, exact fixes.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to perform comprehensive code quality checks including pylint, pytest, and mypy analysis on Python projects, with smart prompts for explaining issues and suggesting fixes.1,500 PyPI21MIT
- AlicenseBqualityBmaintenanceAn MCP server that performs comprehensive Python code analysis using Ruff, ty, and Vulture for linting, type checking, and dead code detection.877 PyPI11MIT
- AlicenseNot gradedqualityDmaintenanceEnables automated Python code quality checks including linting, complexity analysis, typo detection, structure validation, duplicate detection, and test coverage, with integration into Cursor IDE and CLI.MIT
- AlicenseAqualityDmaintenanceProvides deep structural analysis of Python source code via AST, including function signatures, call graphs, cyclomatic complexity, code smells, dead code detection, and protocol conformance.20MIT