IGDB MCP Server

IGDB MCP Server

Accede a la API de IGDB (Internet Game Database) a través del Protocolo de Contexto de Modelo (MCP)

Resumen

El servidor MCP de IGDB proporciona acceso fluido a la Internet Game Database (IGDB) a través del Protocolo de Contexto de Modelo. IGDB es una base de datos completa que contiene información sobre videojuegos, incluyendo:

• Metadatos de juegos (títulos, descripciones, calificaciones)
• Fechas de lanzamiento y plataformas
• Información de desarrolladores y editores
• Géneros, temas y modos de juego
• Calificaciones de usuarios y métricas de hype
• Portadas y medios

Características principales

• Acceso completo a la API de IGDB: Busca juegos, obtén información detallada, encuentra títulos en tendencia
• Caché inteligente: Los tokens OAuth se almacenan en caché para minimizar la sobrecarga de autenticación
• Consultas flexibles: Usa búsquedas simples o el lenguaje de consulta avanzado Apicalypse
• Prompts predefinidos: Consultas comunes listas para usar
• Seguridad de tipos: Construido con Pydantic para una validación de datos robusta

Inicio rápido

Obtén credenciales de IGDB

1. Crea una cuenta de Twitch (si no tienes una)
2. Ve a Consola de desarrollador de Twitch → Registra tu aplicación
3. Obtén tu Client ID y genera un Client Secret

📖 Guía completa de autenticación de IGDB

Opción A: instalar vía Smithery

Para instalar igdb-mcp-server automáticamente vía Smithery:

npx -y @smithery/cli install @bielacki/igdb-mcp-server

Opción B: instalar con uvx

Instala uv.

Añade esto a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "igdb-mcp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/bielacki/igdb-mcp-server.git", "igdb-mcp-server"],
      "env": {
        "IGDB_CLIENT_ID": "your_client_id",
        "IGDB_CLIENT_SECRET": "your_secret"
      }
    }
  }
}

Comienza a explorar

Comienza a explorar con estos ejemplos de prompts:

🔍 Búsqueda y descubrimiento

• "Busca Elden Ring y sus expansiones"
• "Encuentra todos los juegos de Persona de los últimos 5 años"
• "Muéstrame juegos similares a Hades"

📊 Información de juegos

• "Obtén detalles sobre Baldur's Gate 3"
• "Cuéntame todo sobre Cyberpunk 2077 incluyendo DLC"
• "¿En qué plataformas está disponible Hogwarts Legacy?"

🔥 Tendencias y populares

• "¿Cuáles son los próximos juegos más esperados?"
• "Muéstrame los juegos indie mejor calificados de 2024"
• "Encuentra juegos con más hype en este momento"

🎯 Consultas avanzadas

• "Encuentra juegos similares a Skyrim con una calificación de 85 o superior"
• "Lista todos los juegos de Larian Studios"
• "Muestra los próximos juegos de Silent Hill y Resident Evil"

Componentes principales

Herramientas

Herramienta	Descripción	Parámetros	Ejemplo de uso
search_games	Busca juegos por nombre	• query (obligatorio): Término de búsqueda • fields: Campos a devolver (predeterminado: información básica) • limit: Número de resultados (1-500, predeterminado: 10)	"Busca juegos de Elden Ring"
get_game_details	Obtén información completa del juego	• game_id (obligatorio): ID del juego en IGDB • fields: Campos a devolver (predeterminado: extenso)	"Obtén detalles para el ID de juego 1942"
get_most_anticipated_games	Encuentra próximos juegos por hype	• fields: Campos a devolver • limit: Número de resultados (1-500, predeterminado: 25) • min_hypes: Recuento mínimo de hype (predeterminado: 25)	"Muestra los juegos más esperados"
custom_query	Ejecuta consultas Apicalypse	• endpoint (obligatorio): Endpoint de la API • query (obligatorio): Cadena de consulta Apicalypse	"Encuentra RPGs calificados por encima de 90"

Recursos

Recurso	Descripción	Devuelve
igdb://endpoints	Lista de todos los endpoints de la API de IGDB	Endpoints disponibles con descripciones
igdb://query-syntax	Guía del lenguaje de consulta Apicalypse	Referencia de sintaxis y ejemplos

Prompts predefinidos

Prompt	Descripción	Caso de uso
search_game	Resultados de búsqueda de juegos formateados	Descubrimiento rápido de juegos con salida limpia
game_details	Información completa del juego	Detalles completos incluyendo calificaciones, plataformas, desarrolladores
most_anticipated	Próximos juegos en tendencia	Descubre juegos no lanzados con hype y estadísticas

Solución de problemas

Errores de autenticación

• "IGDB_CLIENT_ID not set": Verifica que la configuración de tu cliente MCP tenga las variables de entorno
• "Invalid credentials": Verifica que tu Client ID y Secret sean correctos
• "Token expired": El servidor maneja la renovación de tokens automáticamente

Límite de velocidad

IGDB permite 4 solicitudes por segundo. El servidor no implementa límite de velocidad, así que:

• Evita consultas repetidas rápidas
• Usa la expansión de campos en lugar de múltiples solicitudes
• Aprovecha multi-query para operaciones por lotes

Problemas comunes de consultas

• Sin resultados: Revisa la ortografía, prueba términos de búsqueda más amplios
• Campos faltantes: Algunos campos pueden ser nulos; manéjalos con elegancia
• Error de sintaxis de consulta: Verifica la sintaxis de Apicalypse, revisa los puntos y comas

Variables de entorno

Asegúrate de que la configuración de tu cliente MCP incluya:

"env": {
  "IGDB_CLIENT_ID": "abc123...",
  "IGDB_CLIENT_SECRET": "xyz789..."
}

Licencia y créditos

Licencia MIT - consulta el archivo LICENSE para más detalles

Créditos:

• API de IGDB por IGDB.com
• Protocolo MCP por Anthropic
• Construido con FastMCP
• Publicado en Smithery

---

Para más información sobre las capacidades de la API de IGDB, visita la documentación oficial de la API de IGDB.