MCP tool to guide Python code refactoring without automatic changes
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"mcp-python-refactoring","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# MCP Python Refactoring [](https://opensource.org/licenses/MIT) [](https://www.python.org/downloads/) [](https://modelcontextprotocol.io/) **A Model Context Protocol (MCP) server that analyzes Python code and provides guided refactoring suggestions without automatically modifying your code.** This tool integrates with AI coding assistants (Claude, ChatGPT, Cursor, etc.) to provide intelligent refactoring guidance. Instead of making automatic code changes, it gives you precise instructions on how to improve your Python code, acting as your refactoring mentor. ## What This Tool Does **For AI Coding Assistants:** - Provides structured JSON responses with refactoring opportunities - Identifies long functions, high complexity code, and dead code - Gives precise line numbers for extract method refactoring - Uses professional tools for comprehensive analysis **For Developers:** - Get step-by-step refactoring instructions - Maintain full control over code changes - Learn refactoring patterns through guided practice - Improve code quality systematically ## How It Differs | Approach | This Tool | Traditional Refactoring Tools | |----------|-----------|-------------------------------| | Integration | Works with any LLM/AI assistant | IDE-specific or standalone | | Guidance | Step-by-step instructions with line numbers | Automatic changes only | | Learning | Educational approach teaches patterns | No learning component | | Control | Developer maintains full control | Tool makes all decisions | ## Installation ### Quick Start with uvx (Recommended) ```bash # Install and run directly from GitHub uvx --from git+https://github.com/slamer59/mcp-python-refactoring.git mcp-python-refactoring ``` ### Development Installation ```bash # Clone and setup for development git clone ht…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.