Python Refactoring Assistant — MCP-сервер для Claude Code
MCP-сервер Python Refactoring Assistant анализирует Python-код и передаёт ИИ-ассистенту пошаговые инструкции по рефакторингу с номерами строк, не меняя файлы на диске.
лицензия не указана обновлён 2026-10-29
Открыть на GitHubЧто делает Python Refactoring Assistant
Сервер подключается к ИИ-ассистенту по протоколу MCP и выполняет статический анализ без автозамены файлов. Внутри задействованы инструменты анализа сложности, поиска мёртвого кода и связей: radon, vulture, rope и jedi. Ответы формируются в структурированном JSON, где указаны точные диапазоны строк для выноса методов и критические узлы.
Помимо MCP-режима пакет содержит автономную утилиту python-refactor-cli. Через неё можно проверять метрики пакетов, тестовое покрытие и безопасность прямо в терминале или передавать вывод скриптам сборки.
Для работы серверу нужен Python 3.13 или выше, либо запуск через Docker-контейнер.
Какие задачи решает
- найти перегруженные функции и рассчитать метрики сложности
- получить точные номера строк для выноса методов в отдельный код
- выявить мёртвый и неиспользуемый код в модулях
- оценить тестовое покрытие пакета перед переработкой логики
Примеры запросов агенту
- Проверь
src/app.pyна слишком длинные функции и предложи варианты для выноса методов. - Оцени тестовое покрытие для папки
src/относительно тестов вtests/.
Как установить Python Refactoring Assistant
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Python Refactoring Assistant
Как установить Python Refactoring Assistant в Claude Code?
Выполните команду claude-code mcp add mcp-python-refactoring uvx --from git+https://github.com/slamer59/mcp-python-refactoring.git python-refactor server и перезапустите клиент.
Меняет ли этот сервер исходные файлы автоматически?
Нет, инструмент работает как советник. Он выдаёт структурированные инструкции и номера строк, а решение о правках остаётся за разработчиком.
Какие системные требования нужны для запуска?
Требуется интерпретатор Python версии 3.13 или запуск в Docker-контейнере через docker run -i mcp-python-refactoring.