Php MCP Protocol Server

🚀 PHP MCP プロトコルサーバ

PHP を Anthropic の Claude AI に統合するための PHP MCP（モデルコンテキストプロトコル）サーバです。公式 SDK MCP をベースに実装されており、互換性があり信頼性の高いソリューションを提供します。

✨ 主な機能

• Claude 内で直接 PHP コードを実行できます。
• Anthropic 公式 SDK MCP をベースに実装されています。
• エラーや例外を適切に処理します。
• 一時ファイルを自動的にクリーンアップします。
• 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

💻 使用例

基本的な使用法

Claude で PHP を使用する例：

以下の PHP コードを実行してくれますか？

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

echo "JSON データ：\n";
echo json_encode($data, JSON_PRETTY_PRINT);
?>

📚 ドキュメント

事前準備

PHP 環境のチェック

サーバを起動する前に、PHP が正しくインストールされていることを確認してください。

npm run verify

サーバの起動

npm start

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

Claude AI との統合

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

🔧 技術詳細

API MCP インターフェース

このサーバは 2 種類の MCP ツールを提供しています。

executePhp

指定された PHP コードを実行し、出力結果を返します。

パラメータ：

• code (文字列)：実行する PHP コード

戻り値：

• output (文字列)：コード実行後の出力
• error (文字列、オプション)：エラーメッセージ（ある場合）
• exitCode (数値、オプション)：PHP プロセスの終了ステータスコード

phpInfo

PHP 環境に関する詳細情報を返します。

パラメータ： なし

戻り値：

• info (文字列)：バージョン、拡張機能、設定を含む PHP 環境情報

📄 ライセンス

MIT

⚠️ 重要提示

サーバが起動できない場合やエラーが発生した場合は、以下の手順を実行してください。

1. PHP がインストールされ、システム PATH に正しく追加されていることを確認します。
2. 7654 ポート（または指定した他のポート）が使用可能であることを確認します。
3. サーバログを確認して詳細なエラー情報を取得します。