Refactoring MCP Server — MCP-сервер для Claude Code
Отдаёт агенту каталог рефакторингов Мартина Фаулера: 71+ приём с предпросмотром изменений и разбором кода на запахи.
claude mcp add mcp-refactoring -- uvx mcp-refactoringЧто делает Refactoring MCP Server
Сервер подключается к агенту и даёт ему пять инструментов. list_refactorings показывает доступные приёмы вместе с их параметрами, preview_refactoring прогоняет изменение вхолостую, apply_refactoring применяет его к файлу, inspect_structure возвращает структуру кода, а analyze_code ищет запахи и предлагает, что с ними делать.
Цель задаётся в родном для языка виде: src/order.py::Order::calculate_total для метода, src/order.py::Order для класса, с диапазоном строк через #L10-L15. Приёмы разложены по категориям из каталога Фаулера — composing methods, moving features, simplifying conditionals и другим. Архитектура подключаемая: бэкенды языков описываются в ~/.mcp-refactoring/config.toml, у каждого свой command и флаг enabled, а переопределить их можно переменными окружения вроде MCP_REFACTORING_PYTHON_COMMAND.
Нужен Python 3.10+ и языковой бэкенд: для Python это molting-cli, без него серверу нечего применять. Первым заявлен Python, остальные языки — в планах.
Какие задачи решает
- проверить, что даст рефакторинг, до правки файлов
- вынести метод из длинного класса по каталогу Фаулера
- переименовать метод во всём проекте без ручного поиска
- найти длинные методы и другие запахи в файле
- посмотреть структуру класса перед разбором
Примеры запросов агенту
- Покажи список рефакторингов для Python из категории composing methods
- Сделай предпросмотр extract-method для
src/order.py::Order::calculate#L10-L15с именемcalculate_tax - Примени rename-method к
src/order.py::Order::calcс новым именемcalculate_total
Как установить Refactoring MCP Server
Командой платформы
claude mcp add mcp-refactoring -- uvx mcp-refactoringuvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-refactoring <команда>
Командой платформы
codex mcp add refactoring-mcp-server -- uvx mcp-refactoringuvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-refactoring <команда>
Файл настроек
{
"mcpServers": {
"refactoring-mcp-server": {
"command": "uvx",
"args": [
"mcp-refactoring"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-refactoring <команда>
Файл настроек
{
"servers": {
"refactoring-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-refactoring"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-refactoring <команда>
Командой платформы
gemini mcp add refactoring-mcp-server uvx mcp-refactoringuvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-refactoring <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Refactoring MCP Server
Как установить Refactoring MCP Server в Claude Code?
Выполните claude mcp add mcp-refactoring -- uvx mcp-refactoring. Команда регистрирует сервер и запускает его через uvx.
Что делает Refactoring MCP Server?
Даёт агенту доступ к каталогу рефакторингов Мартина Фаулера: список приёмов, предпросмотр изменений, применение к коду, разбор структуры и поиск запахов.
Что нужно для работы сервера?
Python 3.10+ и языковой бэкенд, для Python — molting-cli. Без бэкенда применять рефакторинги нечем.
