PHP MCP Protocol Server

PHP MCP Protocol Server

PHP と Anthropic の Claude AI を統合できる、PHP 用の MCP（Model Context Protocol）サーバーです。公式の MCP SDK を使用して、堅牢でプロトコルに準拠したソリューションを提供します。

機能

• Claude から PHP コードを直接実行
• Anthropic の公式 MCP SDK に基づく実装
• エラーと例外を適切に処理
• 一時ファイルを自動的にクリーンアップ
• PHP 環境の確認をサポート

要件

• Node.js（v14 以上）
• PHP（v7.0 以上）
• npm または yarn

インストール

グローバル（推奨）

npm install -g php-mcp-protocol-server

グローバルインストール後、次のコマンドでサーバーを起動できます。

php-mcp-server

npm を使用したローカルインストール

npm install php-mcp-protocol-server

GitHub 経由

git clone https://github.com/Lucasdoreac/php-mcp-protocol-server.git
cd php-mcp-protocol-server
npm install

使用方法

PHP 環境を確認する

始める前に、PHP が正しくインストールされていることを確認してください。

npm run verify

サーバーを起動する

npm start

デフォルトでは、サーバーはポート 7654 で待ち受けます。環境変数 MCP_PORT を設定すると変更できます。

Claude AI との統合

1. PHP MCP サーバーを起動します
2. Claude Desktop アプリで、localhost:7654 のローカル MCP ツールを使用するように設定します
3. これで、Claude から PHP コードを直接実行できます！

MCP API

サーバーは 2 つの MCP ツールを公開します。

executePhp

PHP コードを実行し、出力を返します。

パラメーター：

• code（string）：実行する PHP コード

戻り値：

• output（string）：PHP コードの出力
• error（string、省略可）：エラーメッセージ（ある場合）
• exitCode（number、省略可）：PHP プロセスの終了コード

phpInfo

PHP 環境の詳細情報を返します。

パラメーター： なし

戻り値：

• info（string）：バージョン、拡張機能、設定などの PHP 環境情報

Claude での使用例

Claude で PHP を使うには、PHP コードの実行を依頼するだけです。たとえば、次のようにします。

Pode executar este código PHP para mim?

<?php
$data = [
  'nome' => 'Exemplo',
  'valor' => 42,
  'timestamp' => time()
];

echo "Dados em JSON:\n";
echo json_encode($data, JSON_PRETTY_PRINT);
?>

トラブルシューティング

サーバーが起動しない場合やエラーが発生した場合は、次の点を確認してください。

1. PHP がインストールされ、システムの PATH に含まれていることを確認します
2. ポート 7654（または設定したポート）が使用可能であることを確認します
3. 詳細なエラーメッセージについて、サーバーのログを確認します

ライセンス

MIT