Wp Code Review MCP Server

🚀 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許可證。

為動態、可維護的開發規範而構建 🛡️