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。