Servidor MCP de BoardGameGeek

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que se integra con la API XML de BoardGameGeek, lo que permite a Claude buscar juegos de mesa, recuperar detalles del juego, obtener colecciones de usuarios y más.

Características

Este servidor proporciona las siguientes herramientas:

1. search-games : Busca juegos de mesa por nombre

2. get-game-details : obtén información detallada sobre un juego de mesa específico

3. get-hot-games : Consigue los juegos de mesa más populares del momento en BoardGameGeek

4. get-user-collection : obtiene la colección de juegos de mesa de un usuario con opciones de filtrado

5. sync-user-collection : Sincroniza la colección de un usuario desde BoardGameGeek

6. get-user-plays : Obtener los juegos de mesa recientes de un usuario

7. sync-user-plays : Sincroniza las jugadas de un usuario desde BoardGameGeek

8. get-similar-games : Obtener juegos similares a un juego específico

Lista de verificación de características

• [x] Buscar

• [x] Obtener detalles del juego

• [x] Juegos populares

• [ ] Obtener reproducciones de usuario

• [ ] Sincronizar reproducciones de usuario

• [ ] Obtener colección de usuarios

• [ ] Sincronizar colección de usuarios

• [ ] Obtener juegos similares

Related MCP server: Claude AI Documentation Assistant

Prerrequisitos

• Node.js 22.5.0 o superior (necesario para compatibilidad experimental con SQLite)

• npm (para la gestión de dependencias)

Construyendo y funcionando

Para construir el servidor:

# Install dependencies
npm install

# Build the TypeScript code
npm run build

Para ejecutar el servidor directamente:

# The --experimental-sqlite flag is required
node --experimental-sqlite build/index.js

Para ejecutar con Docker:

# Build the Docker image
docker build -t bgg-mcp-server .

# Run the container
docker run --rm -i bgg-mcp-server

Pruebas

Para verificar que el servidor funciona correctamente:

# Make sure the server is built first
npm run build

# Run the test script with the experimental SQLite flag
node --experimental-sqlite test-mcp.js

El script de prueba hará lo siguiente:

1. Iniciar el servidor MCP

2. Pruebe la funcionalidad de búsqueda de juegos

3. Pruebe la funcionalidad de obtener juegos populares

4. Mostrar resultados y cualquier error

Uso con Claude para escritorio

1. Abra el archivo de configuración de Claude for Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Ventanas: %APPDATA%\Claude\claude_desktop_config.json

2. Agregue la configuración del servidor para la ejecución directa de Node.js:

{
  "mcpServers": {
    "boardgamegeek": {
      "command": "node",
      "args": ["--experimental-sqlite", "/path/to/bgg-mcp-server/build/index.js"]
    }
  }
}

3. O utilice Docker (recomendado):

{
  "mcpServers": {
    "boardgamegeek": {
      "command": "bash",
      "args": ["-c", "cd /path/to/bgg-mcp-server && docker build -t bgg-mcp-server . && docker run --rm -i -v \"$(pwd)/data:/app/data\" bgg-mcp-server"]
    }
  }
}

Nota: la opción -v "$(pwd)/data:/app/data" monta el directorio data local en el directorio /app/data en el contenedor Docker, lo que garantiza que la base de datos SQLite persista fuera del contenedor.

4. Reiniciar Claude para escritorio

Preguntas de ejemplo

Una vez conectado con Claude, puedes hacerle preguntas como:

• ¿Cuáles son los nuevos juegos de moda en BoardgameGeek?

• Busca el juego Molly House en boardgamegeek.

Almacenamiento de datos

El servidor utiliza SQLite para la persistencia de datos. Todos los datos de juego recuperados, las colecciones de usuarios y el historial de juego se almacenan en el archivo de base de datos data/bgg.sqlite . Esto:

• Reduce las llamadas API a BoardGameGeek

• Mejora los tiempos de respuesta para consultas repetidas

• Mantiene los datos entre reinicios del servidor

La base de datos se crea automáticamente si no existe y se completará a medida que utilice el servidor.