Akiojin Playfab MCP Server

🚀 PlayFab MCP 服務器

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轉換為Title Player Account 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獲取您的Title ID和Developer Secret Key）。
• 支持的LLM客戶端，例如Claude Desktop。

設置項目

從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 Server交互：

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 Server交互並使用其功能了。