BGG MCP: Servidor API BoardGameGeek MCP

[ADVERTENCIA]
Este proyecto está en desarrollo activo, por lo tanto espere que las herramientas cambien.

BGG MCP proporciona acceso a la API BoardGameGeek a través del Protocolo de Contexto de Modelo, permitiendo la recuperación y filtrado de datos de juegos de mesa, colecciones de usuarios y perfiles. El servidor está implementado en Go, utilizando la biblioteca GoGeek, que ayuda a garantizar interacciones API robustas.

Ejemplo

Herramientas

• Detalles del juego (busca el juego por su nombre, actualmente devuelve la mejor coincidencia)
• Colección (buscar y filtrar la colección de un usuario)
• Hottness (obtiene el hotness actual de BGG)
• Usuario (encuentra detalles de un usuario por nombre de usuario)

Hoja de ruta

• Detalles específicos del juego (por nombre)
• Colección (+ filtros)
• Juegos calientes
• Detalles del usuario
• Búsqueda general
• Juegos recomendados

Configuración

Tienes dos opciones para la configuración, la más fácil es utilizar la integración de Smithery.

A) Instalación vía Smithery

Para instalar bgg-mcp para Claude Desktop automáticamente vía Smithery:

npx -y @smithery/cli install @kkjdaniel/bgg-mcp --client claude

B) Instalación Manual

1. Instalar Go

Necesitará tener Go instalado en su sistema para construir binarios. Esto puede ser facilmente descargado e instalado aqui, o puede usar el gestor de paquetes que prefiera como Brew.

2. Construir

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

# Construir la aplicación (la salida va a build/bgg-mcp) make build # Limpiar los artefactos make clean # Tanto limpiar como construir make all

O puedes simplemente construirlo directamente con Go...

go build -o build/bgg-mcp

3. Añadir configuración MCP

En el settings.json (VS Code / Cursor) o claude_desktop_config.json agrega lo siguiente a tu lista de servidores, apuntandolo al binario que creaste antes, una vez que cargues tu herramienta AI deberias ver las herramientas provistas por el servidor conectado:

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

Puede encontrar más detalles para configurar Claude aquí.

Usando Makefile

El proyecto incluye un Makefile para simplificar la construccion y manejo del binario.

# Construir la aplicación (la salida va a build/bgg-mcp) make build # Limpiar los artefactos make clean # Tanto limpiar como construir make all