Playfab MCP Server

🚀 PlayFab MCP サーバー

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

🤔 これは何ですか？

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

簡単な例

あなた： "最新の10個のアイテムを表示して。"
Claude： *PlayFabのsearch_items APIを呼び出し、結果を純粋なテキスト形式で返す*

🛠️ どのように動作しますか？

このサーバーは、モデルコンテキストプロトコル（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に変換します。

🚀 クイックスタート

Smitheryを通じてのインストール

Smitheryを通じてClaude Desktop用のPlayFab MCP Serverを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @akiojin/playfab-mcp-server --client claude

前提条件

• Node.js 14以上。
• 有効なPlayFabアカウント（PlayFab Game ManagerからタイトルIDと開発者秘密鍵を取得）。
• Claude DesktopなどのサポートされるLLMクライアント。

プロジェクトの設定

PlayFab Game ManagerからタイトルIDと開発者秘密鍵を取得し、プロジェクトのルートディレクトリに.envファイルを作成して、以下の内容を追加します（プレースホルダーを実際の値に置き換えてください）。

PLAYFAB_TITLE_ID=
PLAYFAB_DEV_SECRET_KEY=

使用開始

1. 依存関係のインストール
   プロジェクトのルートディレクトリで以下のコマンドを実行して、すべての必要な依存関係をインストールします。

   npm install
   

2. プロジェクトのビルド
   以下のコマンドを使用してプロジェクトをビルドします。

   npm run build
   

3. サーバーの起動
   以下のコマンドを使用してサーバーを起動します。

   npm start
   

Cursor Desktopでの使用

1. Cursorをインストールします。
2. mcp.jsonファイルをコピーし、その値を更新します。

Claude Desktop設定にPlayFab MCP Serverを追加

1. Claude Desktopの設定オプションを見つけます。
2. 設定ファイルを編集し、サーバーのパスと環境変数を指定します。