🚀 WordPress代码审查MCP服务器v2.0

这是一款专为开发团队打造的轻量级、可配置的MCP（模型上下文协议）服务器。它能够从外部源或你托管自定义规则的URL获取编码规范、安全规则和验证模式。

🚀 快速开始

本服务器可帮助开发团队动态获取和应用编码规范，为代码审查提供便利。以下将详细介绍其使用步骤。

✨ 主要特性

• ✅ 无硬编码规则 - 可从任意URL获取规范。
• ✅ 动态配置 - 通过环境变量指定规则源。
• ✅ 自定义验证 - 可添加自定义的编码标准和安全规则。
• ✅ 轻量级 - 采用外部规则，代码库精简。

📋 可用工具

• get_guidelines - 按类别获取开发规范。
• validate_code - 根据配置的标准验证代码。
• security_check - 进行安全漏洞扫描。

📋 先决条件

• 已安装Node.js（v18+）

📦 安装指南

步骤1：克隆仓库

git clone https://github.com/miniOrangeDev/wp-code-review-mcp-server.git
cd wp-code-review-mcp

步骤2：安装依赖并构建

npm install
npm run build

步骤3：托管规则文件

将sample-guidelines/html/目录下的文件托管到你的Web服务器上，并配置基础URL，例如：https://yourdomain.com/guidelines/。

MCP服务器将获取以下文件：

• https://yourdomain.com/guidelines/guidelines.md
• https://yourdomain.com/guidelines/validation-rules.md
• https://yourdomain.com/guidelines/security-rules.md

步骤4：配置Cursor

在Cursor设置中添加以下内容（Ctrl+Shift+P → "Preferences: Open User Settings (JSON)"）：

{
  "mcpServers": {
    "wp-code-review-mcp": {
      "command": "node",
      "args": ["/path/to/wp-code-review-mcp-server/build/index.js"],
      "env": {
        "GUIDELINES_URL": "https://yourdomain.com/guidelines"
      }
    }
  }
}

请将/path/to/wp-code-review-mcp-server替换为实际路径（例如，/home/wp-code-review-mcp-server）

⚠️ 重要提示

之所以需要指定路径，是因为这是一个本地MCP服务器，与已发布的npm包不同。该路径可让Cursor准确找到已构建的服务器文件。

若未看到MCP服务器已连接，可重启Cursor，之后MCP服务器即可使用。

规则文件格式

规则服务器应提供以下文件：

• /guidelines.md - 主要开发规范
• /validation-rules.md - 代码验证规则
• /security-rules.md - 安全扫描规则

步骤5：在Cursor中测试

1. 在Cursor中打开任意PHP文件。
2. 向AI提问："Check this code for security issues: class mo_Test {}"
3. AI应能检测到短前缀违规！

🔧 技术细节

若在配置过程中遇到问题，请参考配置故障排除指南，其中包含常见错误及解决方案。

📚 详细文档

可通过编辑sample-guidelines/html/目录下的文件来添加自定义内容，包括：

• 编码标准
• 验证规则
• 安全模式
• 公司特定规范

MCP服务器会自动使用更新后的规则，无需重启。

📄 许可证

本项目采用MIT许可证。

为动态、可维护的开发规范而构建 🛡️