Skip to main content
Glama

quick-game-mcp

Servidor MCP especializado em criação de jogos. Ele conduz o assistente (Claude ou qualquer cliente MCP) por todas as etapas centrais de um jogo, do conceito ao lançamento, e cuida da parte técnica: o usuário só precisa idealizar.

  • 12 etapas guiadas, cada uma com perguntas em linguagem simples, campos a preencher e skills recomendadas.

  • 87 skills carregadas sob demanda: 12 próprias em português (uma por etapa) e 75 da comunidade (Godot, Unity, Unreal, Phaser, gêneros, game feel, publicação…). Basta soltar uma pasta com SKILL.md em skills/ para adicionar mais.

  • Protótipo jogável instantâneo em HTML5 (abre no navegador, sem instalar nada), com nome, objetivo e paleta do jogo e parâmetros de sensação ajustáveis por conversa.

  • GDD e backlog gerados automaticamente a partir das decisões.

Etapas

#

Etapa

O que sai dela

1

Conceito

pitch, gênero, fantasia do jogador, público, 3 pilares

2

Loop principal

ciclo do jogador, verbos, vitória e derrota

3

Mecânicas e controles

regras de cada mecânica, inimigos, controles

4

Progressão, dificuldade e economia

progressão, recompensas, curva, moedas

5

Escopo, plataforma e MVP

plataforma, tecnologia (decidida pelo assistente), prazo, MVP

6

Mundo e narrativa (opcional)

ambientação, protagonista, história, tom

7

Direção de arte e áudio

estilo, paleta, áudio, lista de assets

8

Conteúdo e níveis

estrutura de fases e quantidade de conteúdo

9

Interface e experiência

HUD, telas, onboarding, acessibilidade

10

Protótipo jogável

HTML5 gerado e iterado com o usuário

11

Playtest e balanceamento

plano de teste, perguntas, ajustes

12

Polimento e lançamento

canal, modelo de negócio, materiais, checklist

Related MCP server: glade-mcp

Ferramentas

Ferramenta

Para quê

criar_jogo

Começa um jogo a partir da ideia do usuário; detecta gênero/tecnologia e sugere skills

listar_jogos, status_jogo

Progresso de cada jogo e próxima etapa

listar_etapas, guia_etapa

Roteiro de cada etapa (perguntas, campos, dicas, skills)

salvar_etapa, anotar_decisao

Registra decisões; fecha a etapa quando os campos obrigatórios estão completos

listar_skills, ler_skill, recomendar_skills, recarregar_skills

Biblioteca de skills e roteador

checar_escopo

Avalia se o MVP cabe no prazo/equipe e aponta riscos

gerar_prototipo

Protótipo HTML5 (plataforma, topdown, nave, narrativa) com ajustes de sensação

gerar_gdd, gerar_backlog

Documento de design e lista de tarefas em markdown

Prompts MCP (para clientes sem o plugin): novo-jogo, continuar-jogo, brainstorm, ajustar-sensacao. Recursos: skill://{nome} e jogo://{slug}/gdd.

Instalação

Requer Node 18+ e o Claude Code.

Como plugin do Claude Code (recomendado)

No terminal:

claude plugin marketplace add danilo-1/quick-game-MCP
claude plugin install quick-game@quick-game-mcp

Ou, dentro de uma sessão do Claude Code: /plugin marketplace add danilo-1/quick-game-MCP e depois /plugin install quick-game@quick-game-mcp.

O plugin traz tudo junto: o servidor MCP (na primeira execução ele instala as dependências e compila sozinho), as 12 skills do núcleo como skills nativas e os comandos:

Comando

O que faz

/quick-game:novo-jogo [ideia]

Cria um jogo do zero, etapa por etapa

/quick-game:continuar-jogo [nome]

Retoma um jogo de onde parou

/quick-game:brainstorm [tema]

Propõe 5 conceitos de jogo

/quick-game:prototipo [jogo] [feedback]

Gera ou ajusta o protótipo jogável

Confira com /mcp (o servidor aparece como plugin:quick-game:quick-game). Os jogos são salvos em ./jogos da pasta onde o Claude foi aberto. Para atualizar: claude plugin update quick-game@quick-game-mcp.

Só o servidor MCP (outros clientes)

claude mcp add quick-game --scope user -- npx -y github:danilo-1/quick-game-MCP

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "quick-game": {
      "command": "npx",
      "args": ["-y", "github:danilo-1/quick-game-MCP"],
      "env": { "QUICK_GAME_WORKSPACE": "/caminho/para/meus-jogos" }
    }
  }
}

Desenvolvimento

npm install                    # instala e compila
npm test                       # teste de ponta a ponta com um cliente MCP real
claude plugin validate .       # valida plugin e marketplace
claude --plugin-dir .          # roda o Claude Code com o plugin desta pasta
npx @modelcontextprotocol/inspector node dist/index.js   # testar as ferramentas numa interface web

Variáveis de ambiente

Variável

Padrão

Uso

QUICK_GAME_WORKSPACE

./jogos

Onde cada jogo é salvo (projeto.json, GDD.md, BACKLOG.md, prototipo/index.html)

QUICK_GAME_SKILLS_DIRS

—

Pastas extras de skills (separadas por :; ; no Windows)

Estendendo

  • Skills: veja skills/README.md. Uma pasta com SKILL.md = uma skill nova. O campo opcional etapas: faz ela ser recomendada automaticamente na etapa certa.

  • Modelos de protótipo: adicione um .html em templates/prototipos/ usando os marcadores __TITULO__ e __AJUSTES__ (e opcionalmente __FASES__/__CENAS__). Ele aparece em gerar_prototipo pelo nome do arquivo.

  • Etapas: estão como dados em src/stages.ts (perguntas, campos, skills).

  • Roteador: palavras-chave de gênero, engine e disciplina em src/skills.ts.

Créditos e licenças

Código e skills em skills/nucleo/: Apache-2.0.

skills/comunidade/awesome-gamedev-agent-skills/: © 2026 Abhishek Barali e contribuidores, Apache-2.0, copiado sem alterações de gamedev-skills/awesome-gamedev-agent-skills. O fluxo em etapas se inspirou no Claude Code Game Studios (MIT).

Available Tools

15 tools
anotar_decisaoAnotar decisãoA

Guarda uma decisão, ideia solta ou mudança de rumo no histórico do jogo (aparece no GDD).

Inputs: jogo (required), texto (required).

checar_escopoChecar escopoB

Avalia se o MVP cabe no prazo e na equipe e aponta riscos comuns (multiplayer, mundo aberto, 3D...).

Inputs: jogo (required).

criar_jogoCriar jogoA

Começa um novo projeto de jogo a partir da ideia do usuário (do jeito que ele falou). Detecta gênero e tecnologia, sugere skills e devolve o guia da primeira etapa.

Inputs: ideia (required), nome.

gerar_backlogGerar backlogB

Transforma o design em uma lista de tarefas (BACKLOG.md) organizada por marcos.

Inputs: jogo (required).

gerar_gddGerar GDDA

Compila tudo o que foi decidido em um Documento de Design do Jogo (GDD.md) na pasta do jogo e devolve o conteúdo.

Inputs: jogo (required).

gerar_prototipoGerar protótipo jogávelA

Gera um protótipo HTML5 jogável (abre direto no navegador, sem instalar nada) usando o gênero, nome, pitch, objetivo e paleta do jogo. Modelos: plataforma, topdown (aventura/roguelike/RPG/sobrevivência), nave (tiro), narrativa (visual novel). 'ajustes' muda parâmetros de sensação/balanceamento (ex.: forcaPulo, gravidade, velocidade, vidas, velocidadeInimigo, ondas, cores). 'fases' (plataforma): lista de fases, cada uma é uma lista de linhas de texto (# chão, = plataforma, * estrela, ! espinho, E inimigo, F bandeira, P início). 'cenas' (narrativa): objeto {idCena: {quem, texto, cenario, cor, escolhas:[{texto, ir, marca?, se?}], fim?}} começando em 'inicio'.

Inputs: jogo (required), cenas, fases, modelo, +1 more.

guia_etapaGuia da etapaA

Devolve o roteiro de uma etapa: objetivo, perguntas em linguagem simples para o usuário, campos a preencher, dicas e skills recomendadas. Sem 'jogo', devolve o guia genérico.

Inputs: etapa (required), jogo.

ler_skillLer skillC

Carrega o conteúdo completo de uma skill (SKILL.md). Com 'referencia', lê um arquivo auxiliar da skill.

Inputs: nome (required), referencia.

listar_etapasListar etapasB

Lista todas as etapas do pipeline de criação de jogos.

Inputs: no named parameters.

listar_jogosListar jogosA

Lista os jogos em andamento e o progresso de cada um.

Inputs: no named parameters.

listar_skillsListar skillsB

Lista as skills disponíveis (próprias e da comunidade), opcionalmente filtrando por categoria ou busca.

Inputs: busca, categoria.

recarregar_skillsRecarregar skillsA

Relê as pastas de skills (use depois de adicionar uma skill nova sem reiniciar o servidor).

Inputs: no named parameters.

recomendar_skillsRecomendar skillsB

Interpreta um pedido em linguagem natural e indica gênero, tecnologia e as skills que devem ser lidas.

Inputs: pedido (required).

salvar_etapaSalvar etapaB

Registra as decisões do usuário em uma etapa (mescla com o que já existe). Use concluir=true depois que o usuário confirmar o resumo; a etapa só fecha se os campos obrigatórios estiverem preenchidos.

Inputs: jogo (required), dados (required), etapa (required), concluir.

status_jogoStatus do jogoB

Mostra o checklist de etapas do jogo, o que falta em cada uma e qual é a próxima.

Inputs: jogo (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 15 tools

    Disambiguation4/5

    Most tools have distinct roles: project creation/listing/status, GDD generation, backlog, scoping, and prototyping. The closest overlap is between 'anotar_decisao' (record loose decisions) and 'salvar_etapa' (persist stage decisions), and between 'guia_etapa'/'listar_etapas', but descriptions differentiate them well enough for an agent to choose correctly.

    Naming Consistency5/5

    All 15 tools follow a consistent Portuguese verb_noun snake_case pattern (criar_jogo, listar_jogos, status_jogo, gerar_gdd, salvar_etapa). No mixed conventions or casing anomalies.

    Tool Count4/5

    15 tools is at the upper end of the ideal 3-15 range but each maps to a concrete step of the game-creation pipeline (idea, stages, GDD, skills, scope, backlog, prototype). Nothing feels gratuitous, though the skills subgroup (listar_skills, ler_skill, recomendar_skills, recarregar_skills) adds density.

    Completeness4/5

    The surface covers the full pipeline from idea to GDD, backlog, scope check, and a playable HTML5 prototype, including skill discovery and stage tracking. Minor gaps exist: no explicit delete/remove for games or decisions, and no direct editing of an already-generated GDD or prototype file beyond regeneration.

    Related MCP Connectors

    • Make games with AI: one MCP server that connects your agent to Unity, Unreal and Godot editors.

      https://ai-game.dev/mcp
    • Generate, edit, and deploy immersive 3D/WebGL web projects from any MCP assistant.

      https://mcp.vulk.dev/mcp
    • Publish HTML5 games in seconds from an AI agent: audience, monetization, analytics.

    • Publish in seconds, get the audience, start monetization, get all analytics — without leaving your agent. Playgama MCP is a remote MCP server for game developers. Point Codex, Claude Code, Cursor or VS Code at it and your agent works inside your Playgama developer cabinet: it creates a game and fills in the form, uploads a build and polls until the engine analysis is done, uploads covers in the exact sizes the form requires, edits the in-app catalog and leaderboards, gets a QA Tool link, and publishes a sandbox — a public link anyone can play, with no moderation step. It can also bring the first players to that sandbox through Playgama DSP, with the first run per game free. 22 tools, 11 of them read-only; every write is annotated as destructive so your client asks first. Submitting to moderation, deleting and payouts are deliberately left out: the agent prepares everything, a human presses the button. Authentication is OAuth 2.1 with dynamic client registration — there is no token to copy. The client opens a browser on first use, and connected agents are listed and revocable in the cabinet. After the link is live the game takes its first players from the Playgama network, and Playgama DSP can send more the same day (beta). Once it clears the session threshold you can switch on advertising — Playgama Ad serves rewarded, interstitial and banner formats through one JS SDK (access by request). Playgama Wrap turns the same game into a standalone site on your own domain with player accounts, in-game purchases and indexable SEO pages (early access), and Playgama Bridge SDK gives one API for ads, leaderboards, payments and platform SDKs when you publish across platforms. Playtime, retention and revenue reports are in the developer dashboard, and payouts start at 100 USD. Product page: https://playgama.com/mcp/ Docs: https://wiki.playgama.com/playgama/mcp Tools reference: https://wiki.playgama.com/playgama/mcp/tools Connected agents: https://developer.playgama.com/mcp

    Related MCP Servers

    • A
      license
      B
      quality
      Not graded
      maintenance
      Enables complete RPG Maker MZ game development through MCP tools, including autonomous game creation from concepts, AI-generated assets using Gemini 2.5 Flash, and programmatic control over maps, events, characters, and databases. Supports full game creation workflow from a single command with automatic story, asset, and implementation generation.
      32
      25
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Connect any MCP-compatible AI client (Claude Code, Cursor, Windsurf) to Unity or Godot. 300+ granular tools, an editor aware system prompt, game design document project context, script semantic search, and skill calibration.
      201
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides AI coding agents with a compact, automatically updated map of game projects—scripts, scenes, prefabs, modules, and assets—so they can understand the existing structure before building. Supports Unity, Unreal, HTML5, and other engines through a single MCP tool.
      MIT