The Game Crafter MCP Server

Diseñadores independientes de juegos de mesa, creadores de juegos de mesa y usuarios de TGC que desean gestionar sus proyectos a través de un asistente de IA en lugar de navegar manualmente por la interfaz web de TGC.

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP de The Game Crafter

Un servidor MCP que conecta asistentes de IA a la API de The Game Crafter, permitiéndote diseñar, gestionar y cotizar juegos de mesa mediante conversación natural.

Explora el catálogo de componentes, crea proyectos de juegos, añade mazos de cartas y tableros, sube ilustraciones y obtén estimaciones de precios al instante, todo a través de tu asistente de IA.

Para quién es

Diseñadores independientes de juegos de mesa, creadores de juegos de tablero y usuarios de TGC que quieran gestionar sus proyectos mediante un asistente de IA en lugar de navegar manualmente por la interfaz web de TGC.

Requisitos previos

Node.js 18 o posterior
Una cuenta de TGC — regístrate aquí
Una clave de API de TGC — genera una aquí

Instalación

Opción 1: Remota (alojada en Apify) — sin necesidad de instalación

Conéctate al servidor alojado en:

https://chillbot3000--tgc-mcp-server.apify.actor/mcp

No se requiere configuración local. Proporciona tus credenciales de TGC cuando llames a la herramienta authenticate. El uso se factura por operación mediante el modelo de pago por evento de Apify (~$0.09 por sesión típica).

También disponible en Glama Connectors.

Opción 2: Local (mediante npx)

Añade el servidor a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

{
  "mcpServers": {
    "thegamecrafter": {
      "command": "npx",
      "args": ["-y", "@alex-gon/tgc-mcp-server"],
      "env": {
        "TGC_API_KEY_ID": "your-api-key-id",
        "TGC_USERNAME": "your-tgc-username",
        "TGC_PASSWORD": "your-tgc-password"
      }
    }
  }
}

Reinicia Claude Desktop. El servidor se descargará automáticamente y aparecerá en tus conexiones MCP.

Alternativa: instalar desde el código fuente

git clone https://github.com/alex-gon/thegamecrafter-mcp-server.git
cd thegamecrafter-mcp-server
npm install && npm run build

Luego usa "command": "node" y "args": ["/absolute/path/to/dist/index.js"] en la configuración anterior.

Configuración

Variable	Requerida	Descripción
`TGC_API_KEY_ID`	Sí	Tu ID de clave de API de TGC
`TGC_USERNAME`	Sí	Tu nombre de usuario de cuenta de TGC
`TGC_PASSWORD`	Sí	Tu contraseña de cuenta de TGC
`TGC_API_BASE`	No	URL base de la API (por defecto `https://www.thegamecrafter.com/api`)
`TGC_UPLOAD_BASE_DIR`	No	Restringe las subidas de archivos a este directorio (por defecto, el directorio de trabajo)

Consulta .env.example para ver una plantilla.

Herramientas disponibles

Herramientas

Herramienta	Descripción	Autenticación
`authenticate`	Crea una sesión de TGC (acepta credenciales como parámetros o usa variables de entorno)	No
`logout`	Destruye la sesión actual de TGC	Sí
`get_game_catalog`	Explora los tipos de componentes imprimibles (cartas, tableros, cajas)	No
`get_component_sizes`	Obtén las dimensiones en píxeles y pulgadas finales de los tipos de componentes	No
`get_component_details`	Obtén información detallada de un tipo de componente o pieza de juego	No
`get_my_designers`	Lista los perfiles de diseñador del usuario autenticado	Sí
`get_my_games`	Lista todos los juegos de un diseñador (paginado)	Sí
`get_game_details`	Obtén información completa del juego con componentes, archivos y precios	Sí
`create_game`	Crea un nuevo proyecto de juego bajo un diseñador	Sí
`update_game`	Actualiza el nombre, la descripción o la visibilidad de un juego	Sí
`delete_game`	Elimina permanentemente un proyecto de juego	Sí
`add_component_to_game`	Añade un componente imprimible o pieza de stock a un juego	Sí
`upload_file`	Sube una imagen a una carpeta de TGC (desde disco o URL)	Sí
`get_pricing_estimate`	Obtén el desglose de costos por componente de un juego	Sí

Recursos

URI	Descripción
`tgc://catalog`	Catálogo completo de tipos de componentes imprimibles (caché de 30 min)
`tgc://game/{id}/summary`	Resumen completo de un proyecto de juego
`tgc://component-sizes`	Dimensiones en píxeles de todos los tipos de componentes (caché de 30 min)

Prompts

Prompt	Descripción
`new_game_setup`	Flujo de trabajo guiado para crear un proyecto de juego completo con componentes
`estimate_game_cost`	Estimación de costos paso a paso para un juego existente

Ejemplos de prompts

Prueba a decirle esto a tu asistente de IA:

"Muéstrame todos mis juegos en The Game Crafter con sus listas de componentes"
"Crea un nuevo juego de cartas llamado Stellar Drift con una baraja de póker estándar y caja de tuck"
"¿Qué dimensiones en píxeles necesito para una imagen de cara de carta de póker?"
"Sube esta imagen y asígnala como la cara frontal de mi mazo de cartas"
"Estima el costo de mi juego según sus componentes actuales"
"Ayúdame a configurar un nuevo proyecto de juego desde cero — guíame paso a paso"
"¿Qué tipos de componentes están disponibles para juegos de mesa?"
"Elimina mi proyecto de juego de prueba"

Limitaciones

Límites de velocidad — El servidor aplica 3 solicitudes/segundo a TGC (por debajo de su límite de 4/seg) con presupuestos por sesión de 500 lecturas y 200 escrituras.
Autenticación — Las credenciales se pueden pasar como parámetros de la herramienta authenticate (requerido para uso remoto) o mediante variables de entorno (para stdio local). El soporte de OAuth 2.1 está planificado para una versión futura.
Subidas de archivos — Máximo 50 MB por archivo. Las imágenes deben tener entre 50x50 y 10,000x10,000 píxeles. Formatos admitidos: PNG, JPG, GIF, BMP, TIFF, SVG, WebP, PDF.
Transporte — Stdio para uso local. HTTP remoto disponible mediante el endpoint alojado de Apify.
Catálogo de solo lectura — El catálogo de componentes y los precios provienen de TGC y no se pueden modificar.

Contribuciones

Los informes de errores y las solicitudes de extracción son bienvenidos. Abre primero un issue para discutir lo que te gustaría cambiar.

Para ejecutar el servidor de desarrollo:

cp .env.example .env    # fill in your credentials
npm run dev             # starts with tsx + hot reload
npm test                # run the test suite

Licencia

MIT