Refactoring MCP Server

mcp-refactoring

LLM に対して、プラグイン可能で言語に依存しないアーキテクチャを通じて Martin Fowler のリファクタリングカタログを提供する MCP（Model Context Protocol）サーバーです。

機能

• 71 種類以上のリファクタリング：Martin Fowler のリファクタリングカタログを完全に実装
• プラグイン可能なアーキテクチャ：複数の言語をサポート（まず Python に対応、Ruby／Java／Go は今後対応予定）
• デフォルトで安全：プレビュー機能で、適用前に変更内容を確認できます
• LLM に最適化：トークン効率に優れた 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。詳細は LICENSE を参照してください。