MCP Phpstan Server

🚀 MCP PHPStan Server (ローカル、依存関係なし)

純粋なPHPで実装された最小限のモデルコンテキストプロトコル（MCP）サーバーで、2つのツールを提供します。

• phpstan_analyze：PHPStanを実行し、読みやすいレポートを返します。
• phpstan_pro：PHPStan ProのJSON出力を実行し（利用可能な場合）、より詳細な診断情報を提供します。

Composerの依存関係はありません。任意のプロジェクトにコピーして使用できるように設計されています。

✨ 主な機能

構造 (DDD)

• src/Domain：ツールの契約と結果
• src/Application：JSON-RPC MCPサーバーとレジストリ
• src/Infrastructure：プロセスランナー、設定、ツールの実装
• bin/mcp-phpstan：標準入出力のエントリーポイント

設定

環境変数または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クライアントを構成して、次のコマンドを使用して標準入出力経由でサーバーを起動します。

/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を返します。

注意事項

• 標準出力への出力は厳密にJSON-RPCメッセージです。ログは標準エラー出力に出力されます。
• phpstanからの非ゼロの終了コードは、エラーだけでなく検出結果を示す場合もあります。出力を解析してエラー状態を判断します。