Playfab MCP Server

🚀 PlayFab MCP Server

This is a middleware that allows large language models (such as Claude and VS Code) to directly interact with PlayFab services. As a secure and efficient translation layer, it connects your AI assistant with various functions of PlayFab, such as item search, segment query, player profile lookup, inventory management, and PlayFab ID conversion.

🚀 Quick Start

Installation via Smithery

To automatically install the PlayFab MCP Server for Claude Desktop via Smithery, run the following command:

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

Prerequisites

• Node.js version 14 or higher.
• A valid PlayFab account (obtain your title ID and developer secret key through the PlayFab Game Manager).
• A supported LLM client, such as Claude Desktop.

Project Setup

Obtain your title ID and developer secret key from the PlayFab Game Manager, then create a .env file in the project root directory and add the following content (replace the placeholders with actual values):

PLAYFAB_TITLE_ID=
PLAYFAB_DEV_SECRET_KEY=

Getting Started

1. Install Dependencies Run the following command in the project root directory to install all necessary dependencies:

   npm install
   

2. Build the Project Build the project using the following command:

   npm run build
   

3. Start the Server Start the server using the following command:

   npm start
   

Usage in Cursor Desktop

1. Install Cursor.
2. Copy the mcp.json file and update its values.

Adding the PlayFab MCP Server to Claude Desktop Configuration

1. Find the settings option in Claude Desktop.
2. Edit the config file and specify the server path and environment variables.

✨ Features

What is it? 🤔

This is a middleware that enables large language models (like Claude and VS Code) to directly interact with PlayFab services. Serving as a secure and efficient translation layer, it links your AI assistant with various PlayFab features, including item search, segment query, player profile lookup, inventory management, and PlayFab ID conversion.

Quick Example

You: "Show the latest 10 items."
Claude: *Call PlayFab's search_items API and return the results in plain text*

How does it work? 🛠️

This server uses the Model Context Protocol (MCP) to establish a common interface between AI models and PlayFab services. Although MCP supports any AI model, it is currently in the developer preview phase.

Follow these steps to get started:

1. Set up your project.
2. Add project details to your LLM client configuration.
3. Start interacting with PlayFab data naturally!

What can it do? 📊

• Search for items using PlayFab's search_items API.
• Retrieve segment details.
• Query player profiles within a specified segment.
• Retrieve current inventory items using the get_inventory_items API.
• Get inventory collection IDs via the get_inventory_collection_ids API.
• Convert PlayFab IDs to title player account IDs using the get_title_player_account_id_from_playfab_id API.