O que é aseprite-mcp?
O aseprite-mcp, do usuário do GitHub giangdvdotdev, combina um servidor MCP em Python, executado com uvx aseprite-mcp, com uma extensão em Lua que carrega dentro do Aseprite 1.3 ou mais recente. Os dois conversam por um WebSocket em 127.0.0.1:9876, então o agente trabalha no sprite aberto no seu editor, e não em arquivos em segundo plano.
Ele registra 30 ferramentas que atuam no sprite ativo: criar sprites e camadas; desenhar pixels em lote, linhas, retângulos, elipses, preenchimentos e apagar; ler de volta a imagem da tela, pixels, regiões, camadas e seleção; desfazer e refazer; adicionar, temporizar e excluir quadros; abrir e salvar arquivos; e exportar PNG e spritesheet. O repositório usa licença MIT, tem cerca de 13 estrelas e 5 commits, e a versão 0.6.0 está no PyPI.
Como instalar aseprite-mcp
uvx aseprite-mcpaseprite-mcp vale a pena?
O aseprite-mcp acerta em algo que muitos servidores de arte deixam de lado: o agente consegue olhar o que desenhou. get_canvas_image e as leituras de pixels e regiões deixam o modelo conferir o sprite entre um traço e outro, o editor mostra cada mudança na hora, e desfazer e refazer são ferramentas, então uma passada ruim pode ser revertida sem que uma pessoa toque no teclado.
O resultado depende do modelo, não do servidor. A galeria do README mostra um ciclo de caminhada de um cachorro e um retrato feito a partir de uma foto pelo Claude Code com Opus 5, e um patinho de borracha de um modelo local Gemma 4 26B em uma RTX 3060 de 12 GB, um bom sinal de que modelos locais pequenos conseguem operá-lo. Desenhar por chamadas de ferramenta é lento e gasta muitos tokens para qualquer coisa além de sprites pequenos, e as 30 ferramentas não incluem nada para paletas ou tilemaps.
O README expõe a questão de segurança com clareza. O WebSocket não tem autenticação; ele se vincula a 127.0.0.1, então outras máquinas não o alcançam, mas qualquer processo no mesmo computador pode controlar o Aseprite enquanto o servidor roda. export_png, save_sprite e export_spritesheet gravam em qualquer caminho absoluto recebido e sobrescrevem o que houver lá, então um agente confuso pode estragar arquivos fora do projeto.
É um projeto de uma pessoa só, com 5 commits no histórico público e duas suítes de testes, pytest para o servidor e um executor em Lua para o plugin, que rodam sem o Aseprite aberto. ASEPRITE_MCP_PORT precisa ser igual nas duas pontas, porque nada negocia a porta. A 9876 padrão fica ao lado da 9877 usada pelos dois servidores de Ableton, e o próprio exemplo do README para mudá-la escolhe a 9877, o que entraria em conflito com qualquer um deles.
Onde ele se destaca
Um desenvolvedor solo fazendo um jogo de plataforma 2D
Rascunhar um sprite de inimigo de 32×32 e um ciclo curto de caminhada
Peça o sprite, depois quadros extras com durações definidas, e exporte um spritesheet direto para a pasta de recursos do jogo. Gratuito, fora o modelo; conte com repintar os detalhes à mão.
Uma equipe de três pessoas em uma game jam
Colocar arte provisória na tela enquanto os outros programam
Uma pessoa dirige o agente no Aseprite; os rascunhos dele bastam para testar a jogabilidade e são trocados depois. Usar um modelo local, como no exemplo da RTX 3060 na galeria, deixa o custo de API em zero.
Uma professora de pixel art
Mostrar aos alunos como uma forma é construída pixel a pixel
Os alunos assistem ao agente desenhar na tela compartilhada e depois usam desfazer para voltar pelos traços e redesenhá-los à mão. O único custo é o modelo em que ele roda.
Antes de decidir
- Configuração
- Adicione uvx aseprite-mcp ao cliente, instale o arquivo .aseprite-extension da versão mais recente, reinicie o Aseprite e procure [MCP] Connected. em View > Console. Qualquer uma das pontas pode iniciar primeiro; o plugin tenta de novo até o servidor aparecer.
- Integrações
- Claude Code, Claude Desktop e outros clientes stdio; modelos locais por meio de agentes como o Pi Agent, segundo a galeria. Requer Aseprite 1.3 ou mais recente.
- Dados e privacidade
- Tudo roda localmente; imagens da tela e pixels que o agente lê de volta vão para o seu provedor do modelo. O WebSocket em 127.0.0.1:9876 não tem autenticação.
- Limites
- 30 ferramentas, todas no sprite ativo; nenhuma ferramenta de paletas ou tilemaps; ASEPRITE_MCP_PORT deve coincidir nas duas pontas; as ferramentas de salvar e exportar sobrescrevem arquivos em qualquer caminho absoluto.
O que é bom
- Desenha ao vivo no editor real, à vista
- A leitura da tela deixa o modelo conferir o próprio trabalho
- Quadros e exportação de spritesheet para animações simples
- Funciona com modelos locais pequenos, segundo a galeria
O que não é
- WebSocket local sem autenticação
- Ferramentas de exportação sobrescrevem qualquer caminho absoluto
- Duas peças para instalar, com a porta ajustada à mão
- Um só mantenedor e cerca de 13 estrelas
Ideal para
Desenvolvedores de jogos independentes e hobbistas no Aseprite que querem que um agente rascunhe sprites pequenos e ciclos de animação simples para depois acabarem à mão.
Alternativas ao aseprite-mcp
aseprite-mcp: perguntas frequentes
- aseprite-mcp vale a pena?
- Uma pequena ponte bem-feita que deixa um agente rascunhar sprites no editor real e ver o próprio trabalho, nova e limitada demais para ser mais que uma ajuda de esboço. Damos nota 3.4 de 5.
- Quanto custa aseprite-mcp?
- Gratuito e de código aberto (MIT). Requer sua própria cópia do Aseprite 1.3 ou mais recente.
- Quais são as desvantagens de aseprite-mcp?
- WebSocket local sem autenticação; ferramentas de exportação sobrescrevem qualquer caminho absoluto; duas peças para instalar, com a porta ajustada à mão; um só mantenedor e cerca de 13 estrelas.
- Para quem aseprite-mcp é indicado?
- Desenvolvedores de jogos independentes e hobbistas no Aseprite que querem que um agente rascunhe sprites pequenos e ciclos de animação simples para depois acabarem à mão.
- aseprite-mcp é seguro para dados da empresa?
- Tudo roda localmente; imagens da tela e pixels que o agente lê de volta vão para o seu provedor do modelo. O WebSocket em 127.0.0.1:9876 não tem autenticação.
- Quais são as melhores alternativas ao aseprite-mcp?
- As alternativas mais próximas que analisamos são Photoshop MCP e Godot MCP.
Respostas verificadas em 14 de nov. de 2026.