PlayFab MCP サーバー

鍛冶屋のバッジ

これは何ですか？🤔

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

簡単な例

You: "Show me the latest 10 items."
Claude: *calls the PlayFab search_items API and returns the results in plain text*

Related MCP server: Code Analysis MCP Server

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

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

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

プロジェクトを設定します。
プロジェクトの詳細を LLM クライアントの構成に追加します。
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 18 以上。
有効な PlayFab アカウント (PlayFab ゲームマネージャー経由でタイトル ID と開発者秘密キーを取得します)。
Claude Desktop などのサポートされている LLM クライアント。

プロジェクトの設定

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

PLAYFAB_TITLE_ID=
PLAYFAB_DEV_SECRET_KEY=

はじめる

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

カーソルを使って実行

カーソルで PlayFab MCP サーバーを使用するには、次の手順に従います。

まだインストールしていない場合は、 Cursor Desktopをインストールしてください。
空のフォルダーでカーソルの新しいインスタンスを開きます。
このリポジトリからmcp.jsonファイルをフォルダーにコピーし、環境に応じて値を更新します。
カーソルを起動します。PlayFab MCP サーバーがツールリストに表示されます。
たとえば、「最新の 10 件のアイテムを表示」のようなプロンプトを試して、サーバーがクエリを正しく処理していることを確認します。

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

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

{
  "mcpServers": {
    "playfab": {
      "command": "npx",
      "args": [
        "-y",
        "@akiojin/playfab-mcp-server"
      ],
      "env": {
        "PLAYFAB_TITLE_ID": "Your PlayFab Title ID",
        "PLAYFAB_DEV_SECRET_KEY": "Your PlayFab Developer Secret Key"
      }
    }
  }
}

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