Repository files navigation

A powerfulModel Context Protocol (MCP) server that provides comprehensive Python code analysis usingRUFF for linting andVULTURE for dead code detection. Perfect for AI assistants, IDEs, and automated code review workflows.

For quick installation, use one of the one-click install buttons below...

For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressingCtrl + Shift + P and typingPreferences: Open User Settings (JSON).

Optionally, you can add it to a file called.vscode/mcp.json in your workspace. This will allow you to share the configuration with others.

Note that themcp key is needed when using themcp.json file.

Using uvx (recommended):

{"mcp": {"servers": {"analyzer": {"command":"uvx","args": ["mcp-server-analyzer"]      }    }  }}

Using Docker:

{"mcp": {"servers": {"analyzer": {"command":"docker","args": ["run","-i","--rm","ghcr.io/anselmoo/mcp-server-analyzer"]      }    }  }}

# Install with uvx (recommended)uvx install mcp-server-analyzer# Install with pippip install mcp-server-analyzer# Run with Dockerdocker run ghcr.io/anselmoo/mcp-server-analyzer:latest# Install from sourcegit clone https://github.com/anselmoo/mcp-server-analyzer.gitcd mcp-server-analyzeruv sync --devuv run mcp-server-analyzer

• 🔍 RUFF Analysis: Comprehensive Python linting with auto-fixes
• 🧹 Dead Code Detection: Find unused imports, functions, and variables with VULTURE
• 📊 Quality Scoring: Combined analysis with quality metrics
• 🚀 FastMCP Framework: High-performance MCP server implementation
• 🐳 Docker Ready: Multi-architecture containers with security signing
• 🔒 Secure: All releases signed with Sigstore for supply chain security

See comprehensive linting analysis examples:📋 RUFF Analysis Preview

Explore dead code detection capabilities:🧹 VULTURE Analysis Preview

Add to yourclaude_desktop_config.json:

{"mcpServers": {"analyzer": {"command":"uvx","args": ["mcp-server-analyzer"]    }  }}

Add to your Zed settings.json:

"context_servers": {"analyzer": {"command":"uvx","args": ["mcp-server-analyzer"]  }}

• Python 3.10+
• uv (recommended) or pip
• Docker (optional)

# Clone repositorygit clone https://github.com/anselmoo/mcp-server-analyzer.gitcd mcp-server-analyzer# Install dependenciesuv sync --dev# Run testsuv run pytest# Run pre-commit hooksuv tool run pre-commit run --all-files# Build Docker imagedocker build -t mcp-server-analyzer.

# Run all testsuv run pytest tests/ -v# Run with coverageuv run pytest --cov=src/mcp_server_analyzer --cov-report=html# Test specific functionalityuv run pytest tests/test_server.py::TestAnalyzer::test_ruff_analysis

The server provides quality scoring based on:

• RUFF Issues: Style violations, potential bugs, complexity metrics
• Dead Code Detection: Unused imports, functions, variables
• Combined Score: Weighted quality assessment (0-100)

• Signed Releases: All releases signed withSigstore
• Container Signing: Docker images signed withCosign
• Trusted Publishing: PyPI releases use GitHub OIDC trusted publishing
• Vulnerability Scanning: Automated security scanning in CI/CD
• Supply Chain Security: SLSA Build Level 3 compliance

• MCP Specification - Learn about Model Context Protocol
• FastMCP Framework - High-performance MCP implementation
• RUFF Documentation - Python linter and formatter
• VULTURE Documentation - Dead code finder

Contributions are welcome! Please see ourContributing Guide for details.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the MIT License - see theLICENSE file for details.

• Astral for RUFF and uv
• Jendrik Seipp for VULTURE
• Model Context Protocol team
• FastMCP framework

Made with ❤️ for better Python code quality