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 命令

确保已安装 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