Skip to main content
Glama

BoardGameGeek MCP Server

by attilad

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

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"] } } }
  1. 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.

  1. 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.

-
security - not tested
F
license - not found
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Un servidor MCP que se integra con la API XML de BoardGameGeek, lo que permite a Claude buscar juegos de mesa, recuperar detalles del juego y acceder a colecciones de usuarios.

  1. Características
    1. Lista de verificación de características
  2. Prerrequisitos
    1. Construyendo y funcionando
      1. Para construir el servidor:
      2. Para ejecutar el servidor directamente:
      3. Para ejecutar con Docker:
    2. Pruebas
      1. Uso con Claude para escritorio
        1. Preguntas de ejemplo
          1. Almacenamiento de datos

            Related MCP Servers

            • -
              security
              F
              license
              -
              quality
              An MCP server for Claude Desktop that allows users to query data from selected Google Cloud datasets by configuring project ID and datasets in the Claude Desktop configuration.
              Last updated -
              Python
              • Apple
            • -
              security
              F
              license
              -
              quality
              An MCP server that integrates with Claude to provide smart documentation search capabilities across multiple AI/ML libraries, allowing users to retrieve and process technical information through natural language queries.
              Last updated -
              Python
            • A
              security
              F
              license
              A
              quality
              An MCP server that allows Claude to interact with Discord by providing tools for sending/reading messages and managing server resources through Discord's API.
              Last updated -
              19
              20
              JavaScript
            • A
              security
              A
              license
              A
              quality
              MCP server that provides Claude AI assistants with the ability to search the web, get news, and perform research using the You.com API.
              Last updated -
              4
              TypeScript
              MIT License
              • Linux
              • Apple

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/attilad/bgg-mcp-server'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server