Refactoring MCP Server

mcp-refactoring

一个 MCP（模型上下文协议）服务，通过可插拔、语言无关的架构，向大模型提供 Martin Fowler 的重构目录。

功能

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

安装

# Using uvx (recommended)
uvx mcp-refactoring

# Using pip
pip install mcp-refactoring

# Using pipx
pipx install mcp-refactoring

要求

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

安装 Python 后端：

pip install molting-cli

Claude Desktop 配置

将以下内容添加到 Claude Desktop 配置中：

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

可用工具

list_refactorings

列出可用的重构及其参数约定。

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

preview_refactoring

预览重构将进行的更改（试运行）。

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

apply_refactoring

对代码库应用重构。

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

inspect_structure

获取代码的结构信息。

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

analyze_code

分析代码中的异味并提出重构建议。

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

目标规范

每种语言均采用其原生约定：

Python

src/order.py::Order::calculate_total        # Method
src/order.py::Order::calculate_total#L10-L15  # Line range
src/order.py::Order                         # Class

配置

创建 ~/.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 的目录：

• 组合方法：extract-method、inline-method 等
• 移动特性：move-method、extract-class 等
• 整理数据：encapsulate-field、replace-type-code 等
• 简化条件表达式：decompose-conditional、guard-clauses 等
• 简化方法调用：rename-method、add-parameter 等
• 处理泛化关系：pull-up-method、extract-interface 等

开发

# Clone the repository
git clone https://github.com/marshally/mcp-refactoring.git
cd mcp-refactoring

# Install in development mode
pip install -e ".[dev]"

# Run tests
pytest

# Run linter
ruff check .

# Run type checker
mypy src/

许可证

MIT 许可证——详情请参阅 LICENSE。