Akiojin Playfab MCP Server

🚀 PlayFab MCP サーバー

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

🚀 クイックスタート

Smitheryを通じたインストール

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

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

前提条件

• Node.js 14以上
• 有効なPlayFabアカウント（PlayFab Game ManagerからTitle IDとDeveloper Secret Keyを取得）
• Claude Desktopなどの対応LLMクライアント

プロジェクトの設定

PlayFab Game ManagerからTitle IDとDeveloper Secret Keyを取得し、プロジェクトのルートディレクトリに.envファイルを作成します。以下の内容を記載し、プレースホルダーを実際の資格情報に置き換えます。

PLAYFAB_TITLE_ID=
PLAYFAB_DEV_SECRET_KEY=

サーバーの起動

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

   npm install
   

2. プロジェクトのビルド
   プロジェクトをコンパイルするには、以下のコマンドを実行します。

   npm run build
   

3. サーバーの起動
   distフォルダに移動し、サーバーを起動します。

   npm start
   

4. 確認メッセージ
   起動後、以下のメッセージが表示されるはずです。

   PlayFab サーバーがstdio上で実行中です
   

Cursorでの実行

PlayFab MCPサーバーをCursorとともに使用するには、以下の手順に従います。

1. Cursor Desktopがインストールされていない場合は、インストールします。
2. ターミナルを開き、以下のコマンドを実行して必要な依存関係をインストールします。

   npm install
   

3. サーバーを起動します。

   npm start
   

4. 別のターミナルウィンドウでCursorを起動します。
5. Cursor内で、以下の内容を入力してPlayFab MCPサーバーとやり取りします。

   const pf = require('playfab');
   
   pf.initialize('your_title_id', 'your_secret_key');
   pf.searchItems('search_term', (error, result) => {
       if (error) {
           console.error('エラー:', error);
       } else {
           console.log('結果:', result);
       }
   });
   

Claude Desktopとの統合

1. Claude Desktopを起動します。
2. Claude内で、以下の内容を入力します。

   const pf = require('playfab');
   
   pf.initialize('your_title_id', 'your_secret_key');
   pf.searchItems('search_term', (error, result) => {
       if (error) {
           console.error('エラー:', error);
       } else {
           console.log('結果:', result);
       }
   });
   

これで、PlayFab MCPサーバーとやり取りし、その機能を利用することができます。

✨ 主な機能

これは何ですか？ 🤔

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

簡単な例

あなた： "最新の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をTitle Player Account IDに変換します。