Add Python Refactoring MCP Server

[slamer59]

This PR adds the Python Refactoring MCP Server to the Docker MCP Registry, providing educational refactoring assistance for Python developers using AI tools.

Server Overview

• Name: Python Refactoring Assistant
• Repository: https://github.com/slamer59/mcp-python-refactoring
• Category: Development
• License: MIT (compatible with Docker MCP Registry requirements)

Key Features

🎓 Educational Approach: Provides step-by-step refactoring instructions without automatically modifying code
🛠️ Professional Tools: Uses industry-standard analysis tools (Rope, Radon, Vulture, Jedi, LibCST, Pyrefly)
🤖 AI Assistant Compatible: Works seamlessly with Claude, GPT, Cursor, Continue, and other AI coding assistants
📚 Learning Focused: Teaches refactoring patterns through guided practice and precise instructions
⚙️ Dual Mode Support: Both guide-only and apply-changes modes for different use cases
🎯 Precise Analysis: Identifies specific issues with exact line numbers and actionable recommendations

Analysis Capabilities

• Functions over 20 lines (extract method opportunities)
• High cyclomatic complexity (>10) using McCabe analysis
• High cognitive complexity (>15) using Complexipy analysis
• Functions with too many parameters (>5)
• Dead/unused code detection via Vulture
• Low maintainability index (<20) using Radon metrics
• Type annotation problems detected by Pyrefly
• Large files (>500 lines) with module splitting recommendations

Available MCP Tools

• analyze_python_code - Comprehensive code analysis with guided suggestions
• extract_function - Extract method refactoring assistance
• quick_analyze - Fast analysis for immediate feedback
• check_types_with_pyrefly - Advanced type checking and quality analysis

Docker Implementation

✅ Dockerfile Created: Located at project root with Python 3.13-slim base
✅ No Additional Configuration: Server works out-of-the-box with no environment variables needed
✅ Container Ready: Optimized for containerized deployment with minimal footprint

Registry Benefits

This server will benefit from Docker MCP Registry's enhanced security features:

• Cryptographic signatures for image integrity
• Software Bill of Materials (SBOM) for transparency
• Provenance tracking for supply chain security
• Automatic security updates
• Enterprise-grade trust and compliance

Installation Methods

Once published, users can access via:

• Docker Desktop's MCP Toolkit
• Docker Hub as mcp/mcp-python-refactoring
• MCP catalog integration

Compliance Verification

✅ MIT License (allows consumption)
✅ Comprehensive documentation provided
✅ Working Dockerfile at repository root
✅ MCP standard compatibility verified
✅ Error handling and logging implemented
✅ Server configuration follows registry format

Target Audience

Perfect for:

• Python developers learning refactoring best practices
• AI assistant users seeking educational code improvement
• Development teams establishing code quality standards
• Educators teaching software engineering principles
• Senior developers mentoring junior team members

This server fills a unique niche by focusing on education rather than automation, helping developers learn while maintaining full control over their code changes.