logiscape/mcp-sdk-php

解決する課題

このプロジェクトは、Model Context Protocol (MCP) の PHP 実装を提供し、PHP 開発者がアプリケーションを AI モデルと統合できるようにします。特に、プロセスが短命でステートレスになりがちな一般的な PHP ウェブホスティング環境（Apache や cPanel など）で MCP サーバーとクライアントを実行する際の課題を解決します。

仕組み

この SDK は完全な MCP 仕様を実装し、クライアントとサーバーの両方の役割をサポートしています。stdio や HTTP などの標準的なトランスポートを使用して通信します。主な特徴は「ステートレスコア」のサポート（仕様リビジョン 2026-07-28）であり、これにより初期化ハンドシェイクとセッション ID が不要になり、ウェブホスティングのリクエスト・レスポンスサイクルに最適です。

対象者

LLM ベースのクライアントからアクセスできる AI 駆動のツール、リソース、プロンプトを構築したい PHP 開発者、または他の MCP サーバーに接続するための MCP クライアントとして機能する PHP アプリケーションを構築したい開発者。

ハイライト

• ステートレスコアサポート: すべてのリクエストに対するセッション ID とハンドシェイクを排除することで、PHP ウェブホスティングに最適化されています。
• デュアルエラネゴシエーション: モダン (2026-07-28) とレガシー (2024-11-05) の MCP 仕様間の互換性を自動的に処理します。
• MCP Apps 拡張: 開発者は単一のメソッド呼び出しで、ホストレンダリングされた HTML UI をツールにアタッチできます。
• Tasks 拡張: ファイルベースのストアを介して長時間実行されるツール呼び出しをサポートし、共有ホスティングでのポーリングとキャンセルを可能にします。
• 適合性テスト済み: 公式の MCP 適合性テストで高い合格率を維持しています。
• CURL と JSON のサポート: PHP 8.1+ 向けに構築され、外部依存関係は最小限に抑えられています。