MCP Refactoring

🚀 MCP重构工具

MCP（模型上下文协议）服务器，通过可插拔、与语言无关的架构，将Martin Fowler的重构目录开放给大语言模型（LLMs）使用。

🚀 快速开始

你可以按照以下步骤快速使用本工具：

1. 安装工具（详见📦 安装指南）。
2. 配置Claude Desktop（详见下方Claude Desktop配置部分）。
3. 利用可用工具进行代码重构（详见💻 使用示例）。

✨ 主要特性

• 71+种重构方式：全面实现了Martin Fowler的重构目录。
• 可插拔架构：支持多种语言（优先支持Python，计划支持Ruby、Java和Go）。
• 默认安全：预览模式可在应用更改前展示修改内容。
• 针对大语言模型优化：采用TOON输出格式，提高令牌效率。

📦 安装指南

安装mcp-refactoring

可以使用以下几种方式安装：

# 使用uvx（推荐）
uvx mcp-refactoring

# 使用pip
pip install mcp-refactoring

# 使用pipx
pipx install mcp-refactoring

安装Python后端

需要安装Python后端，可使用以下命令：

pip install molting-cli

安装要求

• Python 3.10+
• 语言后端（例如，Python使用molting-cli）

Claude Desktop配置

在Claude Desktop配置文件中添加以下内容：

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

💻 使用示例

基础用法

列出可用的重构方式

列出可用的重构方式及其参数契约：

list_refactorings(language="python", category="composing_methods")

预览重构更改

预览重构会产生的更改（试运行）：

preview_refactoring(
    refactoring="extract-method",
    target="src/order.py::Order::calculate#L10-L15",
    params={"name": "calculate_tax"}
)

应用重构

将重构应用到代码库：

apply_refactoring(
    refactoring="rename-method",
    target="src/order.py::Order::calc",
    params={"new_name": "calculate_total"}
)

检查代码结构

获取代码的结构信息：

inspect_structure(path="src/order.py", depth="method")

分析代码

分析代码中的坏味道并建议重构方式：

analyze_code(path="src/order.py", smells=["long-method"])

目标规范

每种语言使用其原生约定：

Python

src/order.py::Order::calculate_total        # 方法
src/order.py::Order::calculate_total#L10-L15  # 行范围
src/order.py::Order                         # 类

配置

创建~/.mcp-refactoring/config.toml文件：

[backends.python]
enabled = true
command = "molting"

[backends.ruby]
enabled = false
command = "molting-rb"

可以使用环境变量覆盖配置：

MCP_REFACTORING_PYTHON_COMMAND=/path/to/molting
MCP_REFACTORING_PYTHON_ENABLED=true

重构类别

基于Martin Fowler的目录：

• 方法组合：提取方法、内联方法等。
• 特性移动：移动方法、提取类等。
• 数据组织：封装字段、替换类型代码等。
• 条件简化：分解条件、保护子句等。
• 方法调用简化：重命名方法、添加参数等。
• 处理泛化：上移方法、提取接口等。

开发

# 克隆仓库
git clone https://github.com/marshally/mcp-refactoring.git
cd mcp-refactoring

# 以开发模式安装
pip install -e ".[dev]"

# 运行测试
pytest

# 运行代码检查器
ruff check .

# 运行类型检查器
mypy src/

📄 许可证

本项目采用MIT许可证，详情请参阅LICENSE。