SpriteCook

Gere sprites, animações, tilesets e arte de jogos com IA.

Documentação

spritecook-mcp

Conecte seu agente de IA (Cursor, VS Code, Claude, Codex, Grok Build e outros) ao SpriteCook para geração de pixel art e assets de jogos com IA.

Configuração Rápida

npx spritecook-mcp setup

Isso irá:

Detectar seus clientes de IA instalados, incluindo Grok Build
Autenticar com uma chave de API quando necessário; Grok Build usa OAuth gerenciado pelo host
Configurar conexões MCP automaticamente
Instalar uma habilidade opcional de agente para integração de IA mais inteligente

As habilidades opcionais incluem orientação atual para polling assíncrono de jobs, saída canônica de sprite_url, descoberta de modelos, configurações de qualidade do GPT-Image-2, fluxos de trabalho guiados de personagens, predefinições salvas, referências de guia de estilo multi-imagem, uploads de arquivos locais, limpeza de fundo, organização e recuperação de assets, e exportações de personagens prontas para Godot.

O que você obtém

Após a configuração, seu agente de IA pode gerar pixel art e assets de jogos diretamente:

"Gere um sprite de espada em pixel art 64x64"

"Crie uma folha de sprites de personagem para meu jogo de plataforma"

"Faça um conjunto de ícones de poção com fundos transparentes"

"Use minha predefinição de personagem para um novo sprite de idle"

"Importe este PNG de chefe local e depois anime-o com um movimento de idle lento"

"Remova o fundo deste asset de personagem e me dê o PNG transparente"

"Renomeie o asset de espada gerado para Iron Sword Pickup"

Configuração Manual

Se preferir configurar manualmente, adicione isso à configuração MCP do seu editor:

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "spritecook": {
      "url": "https://api.spritecook.ai/mcp/",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code (.vscode/settings.json):

{
  "mcp": {
    "servers": {
      "spritecook": {
        "type": "http",
        "url": "https://api.spritecook.ai/mcp/",
        "headers": { "Authorization": "Bearer YOUR_API_KEY" }
      }
    }
  }
}

Grok Build (.grok/config.toml ou ~/.grok/config.toml):

[mcp_servers.spritecook]
url = "https://api.spritecook.ai/mcp/oauth"
enabled = true
tool_timeout_sec = 6000

Abra /mcps no Grok Build e autentique spritecook. O Grok armazena e atualiza as credenciais OAuth sem expô-las ao modelo. Se as ferramentas não aparecerem, execute grok mcp doctor spritecook e grok inspect.

O repositório também inclui um .mcp.json raiz para uma submissão ao marketplace do Grok Build. Publicar a listagem no marketplace é uma etapa separada de lançamento.

Variáveis de Ambiente

SPRITECOOK_API_URL - Substitui a URL base da API (para desenvolvimento local)