IGDB MCP Server

IGDB MCP Server

Acesse a API do IGDB (Internet Game Database) através do Model Context Protocol (MCP)

Visão Geral

O IGDB MCP Server fornece acesso contínuo ao Internet Game Database (IGDB) através do Model Context Protocol. O IGDB é um banco de dados abrangente contendo informações sobre videogames, incluindo:

• Metadados de jogos (títulos, descrições, avaliações)
• Datas de lançamento e plataformas
• Informações de desenvolvedores e publicadores
• Gêneros, temas e modos de jogo
• Avaliações de usuários e métricas de hype
• Arte de capa e mídia

Principais Recursos

• Acesso Completo à API do IGDB: Pesquise jogos, obtenha informações detalhadas, encontre títulos em alta
• Cache Inteligente: Tokens OAuth são armazenados em cache para minimizar a sobrecarga de autenticação
• Consultas Flexíveis: Use buscas simples ou a linguagem de consulta avançada Apicalypse
• Prompts Prontos: Consultas comuns prontas para uso
• Type-Safe: Construído com Pydantic para validação robusta de dados

Início Rápido

Obtenha Credenciais do IGDB

1. Crie uma conta Twitch (se você não tiver uma)
2. Vá para o Console de Desenvolvedor Twitch → Registre Sua Aplicação
3. Obtenha seu Client ID e gere um Client Secret

📖 Guia completo de autenticação do IGDB

Opção A: instalar via Smithery

Para instalar o igdb-mcp-server automaticamente via Smithery:

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

Opção B: instalar com uvx

Instale o uv.

Adicione isto à configuração do seu 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"
      }
    }
  }
}

Comece a Explorar

Comece a explorar com estes exemplos de prompts:

🔍 Busca e Descoberta

• "Pesquise por Elden Ring e suas expansões"
• "Encontre todos os jogos Persona dos últimos 5 anos"
• "Mostre-me jogos semelhantes a Hades"

📊 Informações do Jogo

• "Obtenha detalhes sobre Baldur's Gate 3"
• "Conte-me tudo sobre Cyberpunk 2077 incluindo DLC"
• "Em quais plataformas Hogwarts Legacy está disponível?"

🔥 Em Alta e Populares

• "Quais são os jogos mais aguardados?"
• "Mostre-me os jogos indie mais bem avaliados de 2024"
• "Encontre jogos com mais hype no momento"

🎯 Consultas Avançadas

• "Encontre jogos semelhantes a Skyrim com avaliação de 85 ou superior"
• "Liste todos os jogos da Larian Studios"
• "Mostre os próximos jogos de Silent Hill e Resident Evil"

Componentes Principais

Ferramentas

Ferramenta	Descrição	Parâmetros	Exemplo de Uso
search_games	Pesquise jogos por nome	• query (obrigatório): Termo de busca • fields: Campos a retornar (padrão: informações básicas) • limit: Quantidade de resultados (1-500, padrão: 10)	"Pesquise por jogos Elden Ring"
get_game_details	Obtenha informações abrangentes do jogo	• game_id (obrigatório): ID do jogo no IGDB • fields: Campos a retornar (padrão: extenso)	"Obtenha detalhes para o jogo ID 1942"
get_most_anticipated_games	Encontre jogos futuros por hype	• fields: Campos a retornar • limit: Quantidade de resultados (1-500, padrão: 25) • min_hypes: Contagem mínima de hype (padrão: 25)	"Mostre os jogos mais aguardados"
custom_query	Execute consultas Apicalypse	• endpoint (obrigatório): Endpoint da API • query (obrigatório): String de consulta Apicalypse	"Encontre RPGs avaliados acima de 90"

Recursos

Recurso	Descrição	Retorna
igdb://endpoints	Lista de todos os endpoints da API do IGDB	Endpoints disponíveis com descrições
igdb://query-syntax	Guia da linguagem de consulta Apicalypse	Referência de sintaxe e exemplos

Prompts Prontos

Prompt	Descrição	Caso de Uso
search_game	Resultados de busca de jogos formatados	Descoberta rápida de jogos com saída limpa
game_details	Informações abrangentes do jogo	Detalhes completos incluindo avaliações, plataformas, desenvolvedores
most_anticipated	Jogos futuros em alta	Descubra jogos não lançados com hype e estatísticas

Solução de Problemas

Erros de Autenticação

• "IGDB_CLIENT_ID não definido": Verifique se a configuração do seu cliente MCP tem as variáveis de ambiente
• "Credenciais inválidas": Verifique se seu Client ID e Secret estão corretos
• "Token expirado": O servidor lida com a renovação do token automaticamente

Limite de Taxa

O IGDB permite 4 requisições por segundo. O servidor não implementa limite de taxa, então:

• Evite consultas repetidas rápidas
• Use expansão de campos em vez de múltiplas requisições
• Aproveite multi-query para operações em lote

Problemas Comuns de Consulta

• Sem resultados: Verifique a ortografia, tente termos de busca mais amplos
• Campos ausentes: Alguns campos podem ser nulos; trate com cuidado
• Erro de sintaxe na consulta: Verifique a sintaxe Apicalypse, confira os pontos e vírgulas

Variáveis de Ambiente

Certifique-se de que a configuração do seu cliente MCP inclua:

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

Licença e Créditos

Licença MIT - veja o arquivo LICENSE para detalhes

Créditos:

• API do IGDB por IGDB.com
• Protocolo MCP por Anthropic
• Construído com FastMCP
• Publicado no Smithery

---

Para mais informações sobre os recursos da API do IGDB, visite a documentação oficial da API do IGDB.