Rector Mcp

Rector

Rector の PHP リファクタリングルールを検索、絞り込みするツールを提供する MCP サーバーです。

インストール

クイックスタート（インストール不要）

GitHub Packages から MCP Rector サーバーを直接実行します。

npx @vasilvestre/mcp-rector

特定のバージョンを使用する場合：

npx @vasilvestre/[email protected]

グローバルインストール

永続的にインストールする場合：

npm install -g @vasilvestre/mcp-rector
mcp-rector

開発環境のセットアップ

ローカルで開発する場合：

npm install
npm run build

MCP クライアントの設定

Claude Desktop（Anthropic）

Claude Desktop の設定ファイルに追加します。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "rector": {
      "command": "npx",
      "args": ["-y", "@vasilvestre/mcp-rector"]
    }
  }
}

特定のバージョンを指定する場合（例：1.0.0）：

{
  "mcpServers": {
    "rector": {
      "command": "npx",
      "args": ["-y", "@vasilvestre/[email protected]"]
    }
  }
}

設定を更新したら、Claude Desktop を再起動して MCP サーバーを有効にします。

Cline（VS Code 拡張機能）

Cline の MCP 設定に追加します。

1. VS Code の設定を開きます（Cmd/Ctrl + ,）
2. 「Cline: MCP Settings」を検索します
3. settings.json を編集します。

{
  "cline.mcpServers": {
    "rector": {
      "command": "npx",
      "args": ["-y", "@vasilvestre/mcp-rector"]
    }
  }
}

または、Cline の MCP Settings UI を使ってサーバーを追加します。

Continue.dev（VS Code/JetBrains 拡張機能）

Continue の設定 ~/.continue/config.json に追加します。

{
  "mcpServers": [
    {
      "name": "rector",
      "command": "npx",
      "args": ["-y", "@vasilvestre/mcp-rector"]
    }
  ]
}

Zed Editor

Zed の設定 ~/.config/zed/settings.json に追加します。

{
  "context_servers": {
    "rector": {
      "command": {
        "path": "npx",
        "args": ["-y", "@vasilvestre/mcp-rector"]
      }
    }
  }
}

グローバルインストールしたパッケージの使用

npx ではなくグローバルインストールを使用する場合：

npm install -g @vasilvestre/mcp-rector

次に、コマンドを直接指定して設定します。

{
  "mcpServers": {
    "rector": {
      "command": "mcp-rector"
    }
  }
}

設定の確認

MCP クライアントを設定した後：

1. アプリケーションを再起動します
2. 利用可能なツール／コンテキストに「mcp-rector」が表示されていることを確認します
3. ツール list-rector-rules、filter-rector-rules、search-rector-rules が表示されていることを確認します

MCP Inspector を使ったローカルでのテスト

MCP Inspector は、クライアントと連携する前に MCP サーバーをローカルでテストするための開発者向けツールです。

Inspector のインストール

npx @modelcontextprotocol/inspector

Inspector でサーバーを実行

npx @modelcontextprotocol/inspector npx -y @vasilvestre/mcp-rector

これにより、以下が行われます。

1. ブラウザーで MCP Inspector の UI が起動します
2. mcp-rector サーバーに接続します
3. 利用可能なすべてのツールを対話的にテストできます

Inspector の使用

Inspector では、以下を利用できます。

• Tools タブ：登録済みのすべてのツール（list-rector-rules、search-rector-rules など）を表示、テストします
• Request/Response パネル：MCP プロトコルのメッセージ全体を確認します
• 対話型テスト：カスタムパラメーターでツールを呼び出し、すぐに結果を確認します

テストの流れの例：

1. Inspector を開きます
2. Tools タブに移動します
3. list-rector-rules を選択します
4. 任意のパラメーターを追加します（例：{"ruleSet": "naming"}）
5. 「Run」をクリックして結果を確認します

利用可能なツール

list-rector-rules

すべての Rector ルールを一覧表示します。ルールセットで絞り込むこともできます。

パラメーター：

• ruleSet（任意）：ルールセットのカテゴリーでルールを絞り込みます（例：「php80」、「code-quality」）

search-rector-rules

複数語のクエリに対応し、キーワードで Rector ルールを検索します。

パラメーター：

• query（必須）：検索キーワードまたは複数語のフレーズ（例：「rename class」）
• ruleSet（任意）：ルールセットのカテゴリーで結果を絞り込みます

機能：

• 複数語をトークンに分割して検索します：「rename class」は「RenameClass」に一致します
• ルール名、説明、タグを検索します
• 関連度順に結果を並べ替えます（最初に名前、次に説明、最後にタグが一致した結果を表示します）

例：

• {"query": "rename class"} → RenameClass、RenameClassConstFetch などが見つかります
• {"query": "type declaration"} → AddParamTypeDeclaration、ReturnTypeDeclaration などが見つかります
• {"query": "php80", "ruleSet": "php80"} → PHP 8.0 のルールセット内のみを検索します

filter-rector-rules

ルールセットのカテゴリーでルールを絞り込みます。

パラメーター：

• ruleSet（必須）：絞り込み対象のルールセット名（大文字と小文字は区別されません）

その他のツールについては、specs/001-list-rector-rules/ に記載されています

開発

npm run build      # Build TypeScript to build/
npm test           # Run tests
npm run test:watch # Run tests in watch mode

トラブルシューティング

npx command not found

Node.js 18 以降と npm がインストールされていることを確認します。

node --version  # Should be >= 18.0.0
npm --version

アクセス許可エラー（Unix/Linux）

パッケージはアクセス許可を自動的に処理します。問題が解決しない場合は、次を試してください。

npx --yes mcp-rector

ネットワーク／レジストリエラー

npm レジストリへの接続を確認します。

npm ping

npx キャッシュのクリア

キャッシュされたバージョンで問題が発生している場合は、npx キャッシュをクリアします。

rm -rf ~/.npm/_npx

Windows での実行に関する問題

Windows では、PowerShell の実行ポリシーを調整する必要がある場合があります。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser