Rector Mcp

What is Rector Mcp?

Rector Mcp is an MCP server that provides tools to query and filter Rector PHP refactoring rules. It helps developers using AI coding assistants to discover and apply Rector rules for PHP code upgrades.

How to use Rector Mcp?

Install via npx @vasilvestre/mcp-rector or globally with npm install -g @vasilvestre/mcp-rector. Configure the server in your MCP client (e.g., Claude Desktop, Cline, Continue.dev, Zed) by adding a mcpServers entry with the npx command. After restarting the client, use the tools list-rector-rules, search-rector-rules, and filter-rector-rules.

Key features of Rector Mcp

• List all available Rector rules with optional rule set filtering.
• Search rules by keyword with multi-word tokenized query support.
• Filter rules by rule set category (case-insensitive).
• Results sorted by relevance (name, description, tags).
• Works with multiple MCP clients: Claude Desktop, Cline, Continue.dev, Zed.

Use cases of Rector Mcp

• Quickly find Rector rules for upgrading PHP code to a specific version (e.g., 8.0).
• Search for rules by concept like “rename class” to find related transformations.
• Filter rules by rule set category (e.g., “code-quality”, “naming”) to narrow results.
• Integrate rule discovery into an AI-assisted coding workflow via MCP clients.

FAQ from Rector Mcp

What tools does Rector Mcp provide?

It provides three tools: list-rector-rules (list with optional rule set filter), search-rector-rules (keyword search with multi-word support), and filter-rector-rules (filter by required rule set name).

What are the system requirements to run Rector Mcp?

Node.js 18+ and npm are required. The server runs via npx or can be globally installed.

How can I test Rector Mcp locally before integrating with a client?

Use the MCP Inspector: run npx @modelcontextprotocol/inspector npx -y @vasilvestre/mcp-rector and test the tools interactively in the Inspector UI.

How do I configure Rector Mcp with Claude Desktop?

Add a rector entry to your Claude Desktop configuration file (e.g., claude_desktop_config.json) with "command": "npx" and "args": ["-y", "@vasilvestre/mcp-rector"].

What should I do if I get permission errors or cache issues?

Ensure Node.js 18+ is installed. On Unix/Linux try npx --yes mcp-rector. Clear npx cache with rm -rf ~/.npm/_npx. On Windows you may need to adjust PowerShell execution policy.