MCP Rector

校长（或校监）

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

安装

快速入门（无需安装）

直接从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桌面配置文件中添加：

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桌面以激活MCP服务器。

Cline（VS Code 扩展）

在您的Cline MCP设置中添加：

1. 打开 VS Code 设置（Cmd/Ctrl + ,）
2. 搜索“Cline：MCP 设置”
3. 编辑 settings.json:

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

或者，使用 Cline MCP 设置用户界面来添加服务器。

Continue.dev（VS Code/JetBrains 扩展）

在继续配置时添加 ~/.continue/config.json:

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

Zed 编辑器

在您的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检测器”或根据具体上下文调整为更贴切的名称，如“MCP监察工具”等） 是一种开发工具，用于在将MCP服务器与客户端集成之前，对本地的MCP服务器进行测试。

安装检查器

npx @modelcontextprotocol/inspector

在Inspector下运行服务器

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

这将会：

1. 在您的浏览器中启动MCP Inspector用户界面
2. 连接到您的mcp-rector服务器
3. 允许您交互式地测试所有可用工具

使用检查器

检查员提供：

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

示例测试流程：

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

可用工具

列出校长规则

列出所有可用的 Rector 规则，并可选择按规则集进行过滤。

参数：

• ruleSet （可选）：按规则集类别过滤规则（例如，“php80”，“code-quality”）

搜索-校长-规定

通过关键词搜索Rector规则，支持多词查询。

参数：

• query （必填）：搜索关键词或多个词的短语（例如，“重命名类”）
• ruleSet （可选）：按规则集类别过滤结果

特点：

• 多词分词搜索：“rename class”匹配“RenameClass”
• 跨规则名称、描述和标签进行搜索
• 按相关性排序的结果（首先匹配名称，然后是描述，最后是标签）

示例：

• {"query": "rename class"} → 查找 RenameClass、RenameClassConstFetch 等。
• {"query": "type declaration"} → 查找 AddParamTypeDeclaration、ReturnTypeDeclaration 等。
• {"query": "php80", "ruleSet": "php80"} → 仅在 PHP 8.0 规则集中搜索

过滤-管教-规则

按规则集类别过滤规则。

参数：

• ruleSet （必填）：用于过滤的规则集名称（不区分大小写）

规范/001-列表-rector规则 中记录的其他工具

发展

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