MCP-сервер PlayFab

значок кузнеца

Что это? 🤔

Этот сервер представляет собой промежуточное ПО, которое позволяет крупным языковым моделям (например, Claude и VS Code) напрямую взаимодействовать с сервисами PlayFab. Действуя как безопасный и эффективный переводчик, он связывает вашего помощника ИИ с различными функциями PlayFab, такими как поиск предметов, запросы сегментов, поиск профилей игроков, управление инвентарем и преобразование идентификаторов 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) для создания универсального интерфейса между моделями ИИ и службами PlayFab. Хотя MCP предназначен для поддержки любой модели ИИ, в настоящее время он доступен в качестве предварительной версии для разработчиков.

Чтобы начать, выполните следующие действия:

Создайте свой проект.
Добавьте сведения о вашем проекте в конфигурацию клиента LLM.
Начните взаимодействовать с данными PlayFab естественным образом!

Что он может делать? 📊

Поиск предметов с помощью API playfab search_items.
Получите исчерпывающую информацию о сегменте.
Запрос профилей игроков в указанных сегментах.
Получите текущие элементы инвентаря с помощью API get_inventory_items.
Получите идентификаторы коллекции инвентаря с помощью API get_inventory_collection_ids.
Конвертируйте идентификатор PlayFab в идентификатор учетной записи игрока Title с помощью API get_title_player_account_id_from_playfab_id.

Быстрый старт 🚀

Установка через Smithery

Чтобы автоматически установить PlayFab MCP Server для Claude Desktop через Smithery :

npx -y @smithery/cli install @akiojin/playfab-mcp-server --client claude

Предпосылки

Node.js 18 или выше.
Действующая учетная запись PlayFab (получите свой Title ID и Developer Secret Key через PlayFab Game Manager).
Поддерживаемый клиент LLM, такой как Claude Desktop.

Настройте свой проект

Получите свой идентификатор PlayFab Title ID и секретный ключ разработчика из PlayFab Game Manager, затем создайте файл .env в корне проекта со следующим содержимым (замените заполнители своими реальными учетными данными):

PLAYFAB_TITLE_ID=
PLAYFAB_DEV_SECRET_KEY=

Начиная

Установка зависимостей В корне проекта выполните следующую команду, чтобы установить все необходимые зависимости:
```
npm install
```
Сборка проекта. Скомпилируйте проект, выполнив:
```
npm run build
```
Запустите сервер. Запустите сервер, выполнив:
```
npm start
```
Подтверждающее сообщение При запуске вы должны увидеть следующее сообщение:
```
PlayFab Server running on stdio
```

Работа с курсором

Чтобы использовать сервер PlayFab MCP с Cursor, выполните следующие действия:

Установите Cursor Desktop, если вы еще этого не сделали.
Откройте новый экземпляр курсора в пустой папке.
Скопируйте файл mcp.json из этого репозитория в свою папку и обновите значения в соответствии с вашей средой.
Запустите курсор; PlayFab MCP Server должен появиться в списке инструментов.
Например, попробуйте ввести запрос «Покажите мне последние 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.