MCP Refactoring

🚀 mcp-refactoring

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

✨ 主な機能

• 71以上のリファクタリング：Martin Fowlerのリファクタリングカタログを完全に実装
• プラガブルなアーキテクチャ：複数の言語をサポート（最初はPython、Ruby/Java/Goも計画中）
• デフォルトで安全：適用前に変更内容をプレビューするモード
• LLM最適化：トークン効率のためのTOON出力形式

📦 インストール

# uvxを使用する場合（推奨）
uvx mcp-refactoring

# pipを使用する場合
pip install mcp-refactoring

# 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        # メソッド
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のカタログに基づいています。

• メソッドの構成：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など

開発

# リポジトリをクローンする
git clone https://github.com/marshally/mcp-refactoring.git
cd mcp-refactoring

# 開発モードでインストールする
pip install -e ".[dev]"

# テストを実行する
pytest

# リンターを実行する
ruff check .

# 型チェッカーを実行する
mypy src/

📄 ライセンス

MITライセンス - 詳細はLICENSEを参照してください。