PlayFab MCP AI 数据库翻译器

@akiojin/playfab-mcp-server

0 Stars 400 次浏览 akiojin 更新于 2026-08-23

一个允许大型语言模型（如 Claude 和 VSCode Copilot）通过自然语言查询与 Azure Cosmos DB 数据交互的服务器，充当人工智能助手和您的数据库之间的翻译器。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

该服务需要配置环境变量：COSMOSDB_KEY、COSMOSDB_URI、COSMOS_CONTAINER_ID、COSMOS_DATABASE_ID

服务介绍

PlayFab MCP 服务器

这是什么？🤔

这个服务器是一个中间件，它使得大型语言模型（如 Claude 和 VS Code）能够直接与 PlayFab 服务进行交互。作为安全高效的翻译器，它将您的 AI 助手与各种 PlayFab 功能连接起来，例如物品搜索、分段查询、玩家资料查找、库存管理以及 PlayFab ID 转换。

快速示例

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

它是如何工作的？🛠️

此服务器利用 Model Context Protocol (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 转换为 Title Player Account ID。

快速启动 🚀

先决条件

Node.js 14 或更高版本。
有效的 PlayFab 账户（通过 PlayFab 游戏管理器获取您的 Title ID 和 Developer Secret Key）。
支持的 LLM 客户端，例如 Claude Desktop。

设置您的项目

从 PlayFab 游戏管理器获取您的 PlayFab Title ID 和 Developer Secret Key，然后在项目根目录下创建一个 .env 文件，并包含以下内容（将占位符替换为您的实际凭据）：

PLAYFAB_TITLE_ID=
PLAYFAB_DEV_SECRET_KEY=

开始使用

安装依赖项
在项目根目录中，运行以下命令以安装所有必要的依赖项：
```
npm install
```
构建项目
通过执行以下命令来编译项目：
```
npm run build
```
启动服务器
导航到 dist 文件夹并使用以下命令启动服务器：
```
npm start
```
确认消息
启动时，您应该看到以下消息：
```
PlayFab Server running on stdio
```

使用 VS Code Insiders 运行

要使用 VS Code Insiders 和 GitHub Copilot 代理模式运行 PlayFab MCP 服务器，请按照以下步骤操作：

安装 VS Code Insiders。
在 VS Code Insiders 中安装 GitHub Copilot 和 GitHub Copilot Chat 扩展的预发布版本。
在一个空文件夹中打开一个新的 VS Code Insiders 实例。
从这个仓库中复制 mcp.json 文件到你的文件夹，并根据你的环境更新其中的值。
启动 GitHub Copilot 并切换到 Agent 模式；PlayFab MCP Server 应该会出现在工具列表中。
例如，尝试使用提示 "Show me the latest 10 items" 来验证服务器是否正确处理了你的查询。

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

打开 Claude Desktop 并导航到文件 → 设置 → 开发者 → 编辑配置。然后，将 claude_desktop_config 文件的内容替换为以下代码片段：

{
  "mcpServers": {
    "playfab": {
      "command": "node",
      "args": [ "C:/Path/To/playfab-mcp/dist/index.js" ], // Specify the path to your PlayFab MCP server file
      "env": {
        "PLAYFAB_TITLE_ID": "Your PlayFab Title ID",
        "PLAYFAB_DEV_SECRET_KEY": "Your PlayFab Developer Secret Key"
      }
    }
  }
}

通过以上步骤，您已成功配置 PlayFab MCP 服务器以供 LLM 客户端使用，从而实现与 PlayFab 服务的无缝交互。

查看源码项目主页