MCP Phpcs Server

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

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

• phpcs_check：PHP_CodeSnifferを実行し、読みやすいレポートを返します。
• phpcbf_fix：PHP Code Beautifier and Fixerを実行します。

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

🚀 クイックスタート

このサーバーを使用する前に、いくつかの設定と実行手順が必要です。以下に詳細を説明します。

✨ 主な機能

• 純粋なPHPで実装されたMCPサーバー。
• phpcs_checkとphpcbf_fixの2つのツールを提供。
• Composerの依存関係がなく、どのプロジェクトにも簡単に組み込める。

📦 インストール

このサーバーにはComposerの依存関係がないため、単にプロジェクトにコピーするだけです。

🔧 技術詳細

構造 (DDD)

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

設定

環境変数またはconfig/config.jsonを使用して設定できます。

• MCP_PHPCS_PATH – phpcsバイナリへのパス（デフォルト: パス上のphpcs）
• MCP_PHPCBF_PATH – phpcbfバイナリへのパス（デフォルト: パス上のphpcbf）
• MCP_PHPCS_RULESET – ルールセットへのパス（例: phpcs.xml）

ルールセットが指定されていない場合、サーバーは現在の作業ディレクトリから上方向に検索し、phpcs.xml、phpcs.xml.dist、ruleset.xmlのいずれかを探します。

実行

一度だけスクリプトを実行可能にします。

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

次に、MCPクライアントを構成して、以下のコマンドを使用して標準入出力経由でサーバーを起動します。

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

例: Claude Desktopの設定

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

💻 使用例

ツール

phpcs_check

入力スキーマ:

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

phpcbf_fix

phpcs_checkと同じ入力スキーマです。

📄 注意事項

• 標準出力への出力は厳密にJSON-RPCメッセージです。ログは標準エラー出力に出力されます。
• phpcsからの非ゼロの終了コードは違反として扱われます（必ずしも致命的なエラーではありません）。