PlayFab MCP 服务器

这是什么？🤔

此服务器是一个中间件，使大型语言模型（如 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 服务器：

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 获取您的 PlayFab 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 Server running on stdio
   

使用 Cursor 运行

要将 PlayFab MCP 服务器与 Cursor 一起使用，请按照以下步骤操作：

1. 如果您尚未安装 Cursor Desktop，请安装它。
2. 在空文件夹中打开 Cursor 的新实例。
3. 将此存储库中的 mcp.json 文件复制到您的文件夹中，并根据您的环境更新值。
4. 启动 Cursor；PlayFab MCP 服务器应出现在工具列表中。
5. 例如，尝试像“显示最新的 10 个物品”这样的提示，以验证服务器是否正确处理您的查询。

将您的项目详细信息添加到 Claude Desktop 的配置文件

打开 Claude Desktop 并导航到 File → Settings → Developer → Edit Config。然后，将 claude_desktop_config 文件内容替换为以下代码段：

{
  "mcpServers": {
    "playfab": {
      "command": "node",
      "args": [ "C:/Path/To/playfab-mcp/dist/index.js" ], // 指定 PlayFab MCP 服务器文件的路径
      "env": {
        "PLAYFAB_TITLE_ID": "您的 PlayFab Title ID",
        "PLAYFAB_DEV_SECRET_KEY": "您的 PlayFab Developer Secret Key"
      }
    }
  }
}

通过这些步骤，您已成功配置 PlayFab MCP 服务器以与您的 LLM 客户端一起使用，从而可以与 PlayFab 的服务进行无缝交互。