PlayFab MCP Server

Què és això? 🤔

Aquest servidor és un middleware que permet a models de llenguatge gran (com Claude i VS Code) interactuar directament amb els serveis de PlayFab. Actuant com a traductor segur i eficient, connecta el teu assistent d'IA amb diverses funcionalitats de PlayFab, com la cerca d'objectes, consultes de segments, cerques de perfils de jugadors, gestió d'inventari i conversió d'identificadors PlayFab.

Exemple Ràpid

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

Com Funciona? 🛠️

Aquest servidor aprofita el Model Context Protocol (MCP) per establir una interfície universal entre models d'IA i els serveis de PlayFab. Tot i que el MCP està dissenyat per donar suport a qualsevol model d'IA, actualment està disponible com a previsualització per a desenvolupadors.

Segueix aquests passos per començar:

• Configura el teu projecte.
• Afegeix els detalls del projecte a la configuració del client LLM.
• Comença a interactuar amb les dades de PlayFab de manera natural!

Què Pot Fer? 📊

Catàleg & Cerca

• Cerca objectes utilitzant l'API search_items de PlayFab.
• Gestió de Catàleg (Economy v2):
  • Crea nous esborranys d'objectes amb l'API create_draft_item.
  • Actualitza esborranys existents amb l'API update_draft_item.
  • Elimina objectes del catàleg amb l'API delete_item.
  • Publica esborranys per fer-los disponibles amb l'API publish_draft_item.
  • Obté informació detallada d'un objecte amb l'API get_item.

Gestió de Jugadors

• Obté informació completa de segments.
• Consulta perfils de jugadors dins dels segments especificats.
• Converteix un ID de PlayFab a un ID de compte de jugador de títol amb l'API get_title_player_account_id_from_playfab_id.
• Obté informació detallada del compte d'usuari amb l'API get_user_account_info.

Gestió d'Inventari

• Operacions de Recuperació:
  • Recupera els objectes d'inventari actuals amb l'API get_inventory_items.
  • Obtén els IDs de col·leccions d'inventari amb l'API get_inventory_collection_ids.
• Operacions d'Afegir/Eliminar:
  • Afegeix objectes a l'inventari amb l'API add_inventory_items.
  • Elimina objectes de l'inventari amb l'API delete_inventory_items.
  • Resta quantitats específiques amb l'API subtract_inventory_items.
• Operacions de Modificació:
  • Actualitza propietats d'objectes amb l'API update_inventory_items.

Administració d'Economy v2

• Executa operacions d'inventari en lot amb l'API execute_inventory_operations.
• Nota: En Economy v2, les monedes virtuals es gestionen com a objectes d'inventari.

Administració de Comptes d'Usuari

• Prohibeix jugadors per ID, IP o adreça MAC amb l'API ban_users.
• Desprohibeix completament jugadors amb l'API revoke_all_bans_for_user.

Gestió de Dades de Jugador

• Obté dades personalitzades de jugadors amb l'API get_user_data.
• Actualitza dades personalitzades de jugadors amb l'API update_user_data.

Gestió de Configuració del Títol

• Estableix dades globals del títol amb l'API set_title_data.
• Obté dades del títol amb l'API get_title_data.
• Estableix dades internes només del servidor amb l'API set_title_internal_data.
• Obté dades internes amb l'API get_title_internal_data.

Inici Ràpid 🚀

Instal·lació via Smithery

Per instal·lar el PlayFab MCP Server per a Claude Desktop automàticament via Smithery:

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

Requisits Prèvius

• Node.js 18 o superior.
• Un compte PlayFab vàlid (obtingues el teu Title ID i Developer Secret Key a través del PlayFab Game Manager).
• Un client LLM compatible com Claude Desktop.

Configura el Teu Projecte

Obté el teu Title ID i Developer Secret Key de PlayFab Game Manager, després crea un fitxer .env a l'arrel del projecte amb el contingut següent (substitueix els valors amb les teves credencials reals):

PLAYFAB_TITLE_ID=
PLAYFAB_DEV_SECRET_KEY=

Instal·lació i Configuració

• Instal·la les Dependències

  Al directori arrel del projecte, executa:

  npm install

Hardcoded step 1:
• ... etc. We'll continue with the rest of the steps as nested lists, preserving the same content but using only
  and
  • . But due to length constraints, the rest of the document has been omitted.