Rector

提供工具查询和过滤Rector PHP重构规则的MCP服务器。

安装

快速开始（无需安装）

直接从GitHub Packages运行MCP Rector服务器：

npx @vasilvestre/mcp-rector

使用特定版本：

npx @vasilvestre/mcp-rector@1.0.0

全局安装

永久安装：

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/mcp-rector@1.0.0"]
    }
  }
}

更新配置后，请重启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设置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提供了：

• 工具标签页：查看并测试所有注册的工具（如list-rector-rules、search-rector-rules等）
• 请求/响应面板：查看完整的MCP协议消息
• 交互式测试：使用自定义参数调用工具并立即查看结果

示例测试流程：

1. 打开Inspector
2. 导航到工具标签页
3. 选择list-rector-rules
4. 添加可选参数（例如，{"ruleSet": "naming"}）
5. 点击“运行”以查看结果

可用工具

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      # 将TypeScript构建到build/
npm test           # 运行测试
npm run test:watch # 在监视模式下运行测试

故障排除

npx命令未找到

确保已安装Node.js 18+和npm：

node --version  # 应该大于等于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