PlayFab MCP Server

PlayFab MCP Server

site icon
2025.04.04 0
JavaScript游戏开发工具PlayFab中间件开发效率
PlayFab MCP Server 是一个中间件,用于连接大型语言模型(如Claude和VS Code)与PlayFab服务。它作为一个安全高效的翻译器,使AI助手能够直接与PlayFab的各种功能交互,包括物品搜索、段查询、玩家资料查询、库存管理以及PlayFab ID转换等。
View on GitHub

Overview

基本能力

产品定位

PlayFab MCP Server 是一个中间件,旨在为大型语言模型提供与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

适用场景

  • 游戏开发中需要AI助手协助管理PlayFab数据
  • 自动化查询和操作PlayFab服务
  • 快速获取和分析游戏物品、玩家资料等信息

工具列表

  • Smithery: 用于自动安装PlayFab MCP Server
  • Cursor Desktop: 支持与PlayFab MCP Server交互的客户端

常见问题解答

  • 如何获取PlayFab Title ID和Developer Secret Key? 通过PlayFab Game Manager获取。
  • 如何确认服务器已成功启动? 启动后应看到消息:"PlayFab Server running on stdio"。

使用教程

使用依赖

  • Node.js 14或更高版本
  • 有效的PlayFab账户(通过PlayFab Game Manager获取Title ID和Developer Secret Key)
  • 支持的LLM客户端,如Claude Desktop

安装教程

  1. 通过Smithery安装: bash npx -y @smithery/cli install @akiojin/playfab-mcp-server --client claude
  2. 设置项目:
  3. 在项目根目录创建.env文件,内容如下: env PLAYFAB_TITLE_ID= PLAYFAB_DEV_SECRET_KEY=
  4. 安装依赖: bash npm install
  5. 构建项目: bash npm run build
  6. 启动服务器: bash npm start

调试方式

  1. 确认服务器启动消息: text PlayFab Server running on stdio
  2. 使用Cursor Desktop测试:
  3. 安装Cursor Desktop
  4. 复制mcp.json文件并更新值
  5. 启动Cursor,尝试查询如"Show me the latest 10 items"
  6. 配置Claude Desktop:
  7. 编辑配置文件,指定PlayFab MCP服务器路径和凭证

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。