MCP Phpstan Server

🚀 MCP PHPStan 服務器（本地運行，無需依賴）

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

• phpstan_analyze：運行 PHPStan 並返回可讀的報告。
• phpstan_pro：運行 PHPStan Pro 以獲取 JSON 輸出（如果可用），用於更豐富的診斷。

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

✨ 主要特性

• 輕量級實現：純 PHP 編寫，無需 Composer 依賴，易於集成到各類項目。
• 雙工具支持：提供 phpstan_analyze 和 phpstan_pro 兩個工具，滿足不同的代碼分析需求。
• 靈活配置：支持通過環境變量或配置文件進行靈活配置。

📦 安裝指南

此項目無需複雜的安裝步驟，只需將其複製到目標項目中即可。

🚀 快速開始

配置

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

• MCP_PHPSTAN_PATH：phpstan 二進制文件的路徑（默認值：先查找 vendor/bin/phpstan，若未找到則在系統路徑中查找 phpstan）。
• MCP_PHPSTAN_CONFIG：phpstan.neon 或 phpstan.neon.dist 文件的路徑（可選；會自動向上級目錄查找）。
• MCP_PHPSTAN_LEVEL：傳遞給 phpstan 的級別（例如 max 或 8），若配置文件中未設置則使用此值。

如果未提供配置，服務器會從當前工作目錄向上查找以下文件之一：phpstan.neon、phpstan.neon.dist。

運行

首先，將腳本設置為可執行：

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

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

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

示例：Claude Desktop 配置

{
  "mcpServers": {
    "phpstan": {
      "command": "/absolute/path/to/mcp/phpstan-server/bin/mcp-phpstan",
      "env": {
        "MCP_PHPSTAN_PATH": "/usr/local/bin/phpstan",
        "MCP_PHPSTAN_CONFIG": "/path/to/your/phpstan.neon",
        "MCP_PHPSTAN_LEVEL": "max"
      }
    }
  }
}

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

• initialize
• tools/list
• tools/call

💻 使用示例

基礎用法

phpstan_analyze

輸入模式：

{
  "type": "object",
  "properties": {
    "paths": {"type": "array", "items": {"type": "string"}},
    "level": {"type": ["string", "integer"], "description": "Override level"}
  },
  "required": ["paths"]
}

phpstan_pro

輸入模式與 phpstan_analyze 相同，但在可能的情況下直接返回 JSON 數據。

🔧 技術細節

項目結構（DDD）

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

注意事項

• 標準輸出（STDOUT）僅輸出 JSON-RPC 消息，日誌信息會輸出到標準錯誤（STDERR）。
• phpstan 的非零退出碼可能表示有代碼問題，也可能表示執行失敗；我們會解析輸出以確定錯誤狀態。