The Game Crafter MCP Server

Designers independentes de jogos de tabuleiro, criadores de jogos de mesa e usuários do TGC que desejam gerenciar seus projetos por meio de um assistente de IA em vez de navegar manualmente pela interface web do TGC.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP do The Game Crafter

Um servidor MCP que conecta assistentes de IA à API do The Game Crafter, permitindo que você projete, gerencie e precifique jogos de tabuleiro por meio de conversa natural.

Navegue pelo catálogo de componentes, crie projetos de jogos, adicione baralhos e tabuleiros, envie artes e obtenha estimativas de preço instantâneas — tudo por meio do seu assistente de IA.

Para quem é

Pré-requisitos

Node.js 18 ou superior
Uma conta TGC — cadastre-se aqui
Uma chave de API TGC — gere uma aqui

Instalação

Opção 1: Remoto (hospedado na Apify) — sem necessidade de instalação

Conecte-se ao servidor hospedado em:

https://chillbot3000--tgc-mcp-server.apify.actor/mcp

Nenhuma configuração local é necessária. Forneça suas credenciais TGC ao chamar a ferramenta authenticate. O uso é cobrado por operação por meio do modelo de pagamento por evento da Apify (~US$ 0,09 por sessão típica).

Também disponível em Glama Connectors.

Opção 2: Local (via npx)

Adicione o servidor à configuração do seu Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json no macOS):

{
  "mcpServers": {
    "thegamecrafter": {
      "command": "npx",
      "args": ["-y", "@alex-gon/tgc-mcp-server"],
      "env": {
        "TGC_API_KEY_ID": "your-api-key-id",
        "TGC_USERNAME": "your-tgc-username",
        "TGC_PASSWORD": "your-tgc-password"
      }
    }
  }
}

Reinicie o Claude Desktop. O servidor será baixado automaticamente e aparecerá nas suas conexões MCP.

Alternativa: instalar a partir do código-fonte

git clone https://github.com/alex-gon/thegamecrafter-mcp-server.git
cd thegamecrafter-mcp-server
npm install && npm run build

Em seguida, use "command": "node" e "args": ["/absolute/path/to/dist/index.js"] na configuração acima.

Configuração

Variável	Obrigatória	Descrição
`TGC_API_KEY_ID`	Sim	Seu ID de chave de API TGC
`TGC_USERNAME`	Sim	Seu nome de usuário da conta TGC
`TGC_PASSWORD`	Sim	Sua senha da conta TGC
`TGC_API_BASE`	Não	URL base da API (padrão: `https://www.thegamecrafter.com/api`)
`TGC_UPLOAD_BASE_DIR`	Não	Restringir uploads de arquivos a este diretório (padrão: diretório de trabalho)

Consulte .env.example para obter um modelo.

Ferramentas disponíveis

Ferramentas

Ferramenta	Descrição	Autenticação
`authenticate`	Criar uma sessão TGC (aceita credenciais como parâmetros ou usa variáveis de ambiente)	Não
`logout`	Encerrar a sessão TGC atual	Sim
`get_game_catalog`	Navegar pelos tipos de componentes imprimíveis (cartas, tabuleiros, caixas)	Não
`get_component_sizes`	Obter dimensões em pixels e polegadas finais para tipos de componentes	Não
`get_component_details`	Obter informações detalhadas de um tipo de componente ou peça de jogo	Não
`get_my_designers`	Listar perfis de designer do usuário autenticado	Sim
`get_my_games`	Listar todos os jogos de um designer (paginado)	Sim
`get_game_details`	Obter informações completas do jogo com componentes, arquivos e preços	Sim
`create_game`	Criar um novo projeto de jogo sob um designer	Sim
`update_game`	Atualizar nome, descrição ou visibilidade de um jogo	Sim
`delete_game`	Excluir permanentemente um projeto de jogo	Sim
`add_component_to_game`	Adicionar um componente imprimível ou peça de estoque a um jogo	Sim
`upload_file`	Enviar uma imagem para uma pasta TGC (do disco ou URL)	Sim
`get_pricing_estimate`	Obter detalhamento de custo por componente de um jogo	Sim

Recursos

URI	Descrição
`tgc://catalog`	Catálogo completo de tipos de componentes imprimíveis (cache de 30 min)
`tgc://game/{id}/summary`	Resumo completo de um projeto de jogo
`tgc://component-sizes`	Dimensões em pixels para todos os tipos de componentes (cache de 30 min)

Prompts

Prompt	Descrição
`new_game_setup`	Fluxo guiado para criar um projeto de jogo completo com componentes
`estimate_game_cost`	Estimativa de custo passo a passo para um jogo existente

Exemplos de prompts

Experimente dizer estas frases ao seu assistente de IA:

"Mostre-me todos os meus jogos no The Game Crafter com suas listas de componentes"
"Crie um novo jogo de cartas chamado Stellar Drift com um baralho padrão de pôquer e caixa de encaixe"
"Quais dimensões em pixels eu preciso para uma imagem de face de carta de pôquer?"
"Envie esta imagem e atribua-a como a face frontal do meu baralho"
"Estime o custo do meu jogo com base nos componentes atuais"
"Ajude-me a configurar um novo projeto de jogo do zero — guie-me pelo processo"
"Quais tipos de componentes estão disponíveis para jogos de tabuleiro?"
"Exclua meu projeto de jogo de teste"

Limitações

Limites de taxa — O servidor aplica 3 requisições/segundo ao TGC (abaixo do limite de 4/segundo deles) com orçamentos por sessão de 500 leituras e 200 gravações.
Autenticação — As credenciais podem ser passadas como parâmetros da ferramenta authenticate (obrigatório para uso remoto) ou por meio de variáveis de ambiente (para stdio local). Suporte a OAuth 2.1 está planejado para uma versão futura.
Uploads de arquivos — Máximo de 50 MB por arquivo. As imagens devem ter entre 50x50 e 10.000x10.000 pixels. Formatos suportados: PNG, JPG, GIF, BMP, TIFF, SVG, WebP, PDF.
Transporte — Stdio para uso local. HTTP remoto disponível por meio do endpoint hospedado na Apify.
Catálogo somente leitura — O catálogo de componentes e os preços vêm do TGC e não podem ser modificados.

Contribuição

Relatórios de bugs e pull requests são bem-vindos. Abra uma issue primeiro para discutir o que você gostaria de alterar.

Para executar o servidor de desenvolvimento:

cp .env.example .env    # fill in your credentials
npm run dev             # starts with tsx + hot reload
npm test                # run the test suite

Licença

MIT