MCP Phpcs Server

🚀 MCP PHPCS服務器（本地，無依賴）

這是一個用純PHP實現的最小化模型上下文協議（MCP）服務器，它提供了兩個工具：

• phpcs_check：運行PHP_CodeSniffer並返回可讀報告。
• phpcbf_fix：運行PHP代碼美化和修復工具。

該服務器無需Composer依賴，可直接複製到任何項目中使用。

🚀 快速開始

運行前準備

將腳本設置為可執行文件：

chmod +x mcp/phpcs-server/bin/mcp-phpcs

啟動服務器

配置你的MCP客戶端，通過標準輸入輸出（stdio）使用以下命令啟動服務器：

/absolute/path/to/mcp/phpcs-server/bin/mcp-phpcs

示例：Claude桌面端配置

在你的MCP配置文件中添加以下內容：

{
  "mcpServers": {
    "phpcs": {
      "command": "/absolute/path/to/mcp/phpcs-server/bin/mcp-phpcs",
      "env": {
        "MCP_PHPCS_PATH": "/usr/local/bin/phpcs",
        "MCP_PHPCBF_PATH": "/usr/local/bin/phpcbf",
        "MCP_PHPCS_RULESET": "/path/to/your/phpcs.xml"
      }
    }
  }
}

該服務器通過標準輸入輸出（STDIN/STDOUT）使用JSON-RPC 2.0協議，並實現了以下方法：

• initialize
• tools/list
• tools/call

✨ 主要特性

• 輕量級：純PHP實現，無需Composer依賴。
• 可移植：可直接複製到任何項目中使用。
• 功能豐富：提供phpcs_check和phpcbf_fix兩個實用工具。

📦 安裝指南

該項目無需安裝額外依賴，只需將代碼複製到項目中即可。

📚 詳細文檔

項目結構（DDD）

• src/Domain：工具契約和結果
• src/Application：JSON-RPC MCP服務器和註冊表
• src/Infrastructure：進程運行器、配置、規則集發現、工具實現
• bin/mcp-phpcs：標準輸入輸出入口點

配置

你可以通過環境變量或config/config.json文件進行配置：

• MCP_PHPCS_PATH – phpcs二進制文件的路徑（默認：PATH中的phpcs）
• MCP_PHPCBF_PATH – phpcbf二進制文件的路徑（默認：PATH中的phpcbf）
• MCP_PHPCS_RULESET – 規則集的路徑（例如：phpcs.xml）

如果未提供規則集，服務器將從當前工作目錄向上搜索以下文件之一： phpcs.xml、phpcs.xml.dist、ruleset.xml。

💻 使用示例

phpcs_check

輸入模式：

{
  "type": "object",
  "properties": {
    "path": {"type": "string"}
  },
  "required": ["path"]
}

phpcbf_fix

輸入模式與phpcs_check相同。

🔧 技術細節

• 輸出到標準輸出（STDOUT）的嚴格為JSON-RPC消息，日誌輸出到標準錯誤（STDERR）。
• phpcs的非零退出代碼被視為違規（不一定是致命錯誤）。