PlayFab MCP サーバー

これは何ですか？🤔

このサーバーは、ClaudeやVS Codeなどの大規模言語モデルがPlayFabサービスと直接やり取りできるようにするミドルウェアです。安全で効率的な翻訳者として機能し、AIアシスタントをアイテム検索、セグメント照会、プレイヤープロフィール検索、インベントリ管理、PlayFab ID変換といったPlayFabの様々な機能に接続します。

簡単な例

どのように機能するのですか？🛠️

このサーバーは、モデルコンテキストプロトコル（MCP）を活用して、AIモデルとPlayFabサービス間のユニバーサルインターフェースを確立します。MCPはあらゆるAIモデルをサポートするように設計されていますが、現在は開発者向けプレビューとして提供されています。

開始するには、次の手順に従ってください。

1. プロジェクトを設定します。
2. プロジェクトの詳細を LLM クライアントの構成に追加します。
3. PlayFab データを自然に操作してみましょう。

何ができるの？📊

• PlayFab の search_items API を使用してアイテムを検索します。
• 包括的なセグメント情報を取得します。
• 指定されたセグメント内のプレーヤー プロファイルを照会します。
• get_inventory_items API を使用して現在の在庫アイテムを取得します。
• get_inventory_collection_ids API を使用してインベントリ コレクション ID を取得します。
• get_title_player_account_id_from_playfab_id API を使用して、PlayFab ID をタイトル プレーヤー アカウント ID に変換します。

クイックスタート 🚀

前提条件

• Node.js 14 以上。
• 有効な PlayFab アカウント (PlayFab ゲーム マネージャー経由でタイトル ID と開発者秘密キーを取得します)。
• Claude Desktop などのサポートされている LLM クライアント。

プロジェクトの設定

PlayFab ゲーム マネージャーから PlayFab タイトル ID と開発者秘密キーを取得し、次の内容を含む.envファイルをプロジェクト ルートに作成します (プレースホルダーを実際の資格情報に置き換えます)。

はじめる

1. 依存関係をインストールする
   プロジェクト ルートで次のコマンドを実行して、必要な依存関係をすべてインストールします。
   npm install
2. プロジェクトを構築する
   次のコマンドを実行してプロジェクトをコンパイルします。
   npm run build
3. サーバーを起動する
   distフォルダに移動し、次のコマンドでサーバーを起動します。
   npm start
4. 確認メッセージ
   起動時に次のメッセージが表示されます。
   PlayFab Server running on stdio

VS Code Insiders で実行する

VS Code Insiders および GitHub Copilot エージェント モードで PlayFab MCP サーバーを使用するには、次の手順に従います。

1. VS Code Insidersをインストールします。
2. VS Code Insiders に GitHub Copilot および GitHub Copilot Chat 拡張機能のプレリリース バージョンをインストールします。
3. 空のフォルダーで VS Code Insiders の新しいインスタンスを開きます。
4. このリポジトリからmcp.jsonファイルをフォルダーにコピーし、環境に応じて値を更新します。
5. GitHub Copilot を起動し、エージェント モードに切り替えると、PlayFab MCP サーバーがツール リストに表示されます。
6. たとえば、「最新の 10 件のアイテムを表示」のようなプロンプトを試して、サーバーがクエリを正しく処理していることを確認します。

Claude Desktop の設定ファイルにプロジェクトの詳細を追加する

Claude Desktopを開き、「ファイル」→「設定」→「開発者」→「設定の編集」に移動します。次に、 claude_desktop_configファイルの内容を以下のコードに置き換えます。

これらの手順により、PlayFab MCP サーバーを LLM クライアントで使用するように正常に構成し、PlayFab のサービスとのシームレスな対話が可能になります。