BGG MCP

BGG MCP permite que herramientas de IA interactúen con la API de BoardGameGeek.

Documentación

BGG MCP: Servidor MCP de BoardGameGeek

BGG MCP proporciona acceso a la API de BoardGameGeek a través del Model Context Protocol, permitiendo la recuperación y el filtrado de datos de juegos de mesa, colecciones de usuarios y perfiles. El servidor está implementado en Go, utilizando la librería GoGeek, que ayuda a garantizar interacciones robustas con la API.

Los datos de precios son proporcionados por BoardGamePrices.co.uk, ofreciendo precios en tiempo real de múltiples minoristas.

Las recomendaciones de juegos están impulsadas por Recommend.Games, que proporciona recomendaciones algorítmicas de similitud basadas en datos de BoardGameGeek.

Demo

▶️ Ver el video de demostración de la herramienta de Reglas

Herramientas

Herramientas principales

Herramienta	Descripción
`bgg-search`	Buscar juegos de mesa con filtrado por tipo (juegos base, expansiones o todos)
`bgg-details`	Obtener información detallada sobre un juego de mesa específico
`bgg-collection`	Consultar y filtrar la colección de juegos de un usuario con amplias opciones de filtrado
`bgg-hot`	Obtener la lista actual de popularidad de BGG
`bgg-user`	Obtener información del perfil de usuario
`bgg-price`	Obtener precios actuales de múltiples minoristas usando IDs de BGG
`bgg-trade-finder`	Encontrar oportunidades de intercambio entre dos usuarios de BGG
`bgg-recommender`	Obtener recomendaciones de juegos basadas en la similitud con un juego específico
`bgg-thread-details`	Obtener el contenido completo de un hilo específico del foro de BGG, incluyendo todas las publicaciones

🧪 Herramientas experimentales

Herramienta	Descripción
`bgg-rules`	Responder preguntas sobre reglas buscando en los foros de BGG discusiones y aclaraciones relevantes

Recursos

BGG MCP expone recursos a los que los asistentes de IA pueden acceder directamente para obtener información contextual:

Recurso	URI	Descripción
`BGG Hotness`	`bgg://hotness`	Lista actual de popularidad de BGG, siempre disponible
`My BGG Collection`	`bgg://my-collection`	Tu colección personal de BGG (requiere que `BGG_USERNAME` esté configurado)

Prompts

BGG MCP incluye prompts preconfigurados para flujos de trabajo comunes:

Prompt	Descripción
`Trade Sales Post`	Generar una publicación de venta formateada para tu colección de 'para intercambiar' de BGG con precios de mercado con descuento
`Game Recommendations`	Obtener recomendaciones personalizadas de juegos basadas en tu colección y preferencias de BGG

Ejemplos de prompts

Aquí tienes algunos ejemplos de prompts que puedes usar para interactuar con las herramientas de BGG MCP:

🔍 Búsqueda

"Search for Wingspan on BGG"
"How many expansions does Grand Austria Hotel have?"
"Search for Wingspan expansions only"

📊 Detalles del juego

"Get details for Azul"
"Show me information about game ID 224517"
"What's the BGG rating for Gloomhaven?"

📚 Colección

"Show me ZeeGarcia's game collection"
"Show games rated 9+ in kkjdaniel's collection"
"List unplayed games in rahdo's collection"
"Find games for 6 players in kkjdaniel's collection"
"Show me all the games rated 3 and below in my collection"
"What games in my collection does rahdo want?"
"What games does kkjdaniel have that I want?"

🔥 Popularidad

"Show me the current BGG hotness list"
"What's trending on BGG?"

👤 Perfil de usuario

"Show me details about BGG user rahdo"
"When did user ZeeGarcia join BGG?"
"How many buddies do I have on bgg?"

💰 Precios

"Get the best price for Wingspan in GBP"
"Show me the best UK price for Ark Nova"
"Compare prices for: Wingspan & Ark Nova"

🎯 Recomendaciones

"Recommend games similar to Wingspan"
"What games are like Azul but with at least 1000 ratings?"
"Find 5 games similar to Troyes"

📖 Reglas (Experimental)

"[Your rules question about any board game] - use bgg-rules"
"How does [game mechanic] work in [game name]? use bgg-rules"
"Can I [specific action] in [game name]? use bgg-rules"
"What happens when [situation] in [game name]? use bgg-rules"

Nota: Incluye "usa bgg-rules" en tu pregunta para asegurar que la IA busque en los foros de BGG las respuestas.

Instalación

Autenticación requerida: La mayoría de las herramientas de BGG MCP requieren autenticación para acceder a la API de BoardGameGeek. Consulta la sección de Configuración a continuación para las instrucciones de configuración.

A) Docker (Recomendado)

BGG MCP está publicado en Docker Hub y listado en el MCP Registry. Añade lo siguiente a tu claude_desktop_config.json (Claude Desktop) o settings.json (VS Code / Cursor):

"bgg": {
    "command": "docker",
    "args": ["run", "-i", "--rm",
        "-e", "BGG_API_KEY",
        "-e", "BGG_USERNAME",
        "kdaniel/bgg-mcp"
    ],
    "env": {
        "BGG_API_KEY": "your_api_key_here",
        "BGG_USERNAME": "your_bgg_username"
    }
}

Consulta Configuración a continuación para obtener detalles sobre cómo obtener una clave de API de BGG y configurar tu nombre de usuario.

Para más detalles sobre cómo conectar servidores MCP a tu cliente, consulta la guía oficial de MCP.

B) Configuración manual

1. Instalar Go

Necesitarás tener Go instalado en tu sistema para compilar el binario. Puedes descargarlo e instalarlo fácilmente aquí, o puedes usar el gestor de paquetes que prefieras, como Brew.

2. Compilar

El proyecto incluye un Makefile para simplificar la compilación y gestión del binario.

# Build the application (output goes to build/bgg-mcp)
make build

# Clean build artifacts
make clean

# Both clean and build
make all

O simplemente puedes compilarlo directamente con Go...

go build -o build/bgg-mcp

3. Añadir configuración de MCP

En el settings.json (VS Code / Cursor) o claude_desktop_config.json añade lo siguiente a tu lista de servidores, apuntando al binario que creaste anteriormente. Una vez que cargues tu herramienta de IA, deberías ver las herramientas proporcionadas por el servidor conectado:

"bgg": {
    "command": "path/to/build/bgg-mcp",
    "args": ["-mode", "stdio"]
}

Más detalles para configurar Claude se pueden encontrar aquí.

Configuración

Autenticación

BGG MCP utiliza la librería GoGeek v3, que requiere autenticación para acceder a la API de BoardGameGeek.

Puedes configurar la autenticación usando ya sea BGG_API_KEY (recomendado) o BGG_COOKIE:

Configuración de autenticación

Opción 1: Clave de API (Recomendado)

Obtén una clave de API desde el formulario de solicitud de API de BoardGameGeek y añádela a tu configuración:

"bgg": {
    "env": {
        "BGG_API_KEY": "your_api_key_here"
    }
}

Opción 2: Autenticación por cookies

Alternativamente, puedes usar autenticación basada en cookies:

"bgg": {
    "env": {
        "BGG_COOKIE": "bggusername=user; bggpassword=pass; SessionID=xyz"
    }
}

Nota: Si se proporcionan ambos, BGG_API_KEY se usará por defecto.

Configuración del nombre de usuario

Opcionalmente, puedes configurar la variable de entorno BGG_USERNAME para habilitar referencias a "yo" y "mi" en las consultas sin necesidad de indicar explícitamente tu nombre de usuario:

"bgg": {
    "env": {
        "BGG_USERNAME": "your_bgg_username",
        "BGG_API_KEY": "your_api_key_here"
    }
}

Esto permite:

Consultas de colección: "Muestra mi colección" en lugar de especificar tu nombre de usuario
Consultas de usuario: "Muestra mi perfil de BGG"
Asistencia de IA: La IA puede usar automáticamente tu nombre de usuario para comparaciones y análisis

Nota: Cuando uses autorreferencias (yo, mi, me) sin configurar BGG_USERNAME, recibirás un mensaje de error claro.