mcp-unity MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

CRUD de Cena e GameObject com controles de transformação
Adicionar/modificar componentes, criar/atribuir materiais
Executor de testes EditMode + PlayMode
Streaming de logs do console
batch_execute para compor múltiplas chamadas de ferramenta atomicamente

Demo ao vivo

Como fica na prática

unity-3.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "unity-3": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/CoderGamester/mcp-unity"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "unity-3": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/CoderGamester/mcp-unity"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "unity-3": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/CoderGamester/mcp-unity"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "unity-3": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/CoderGamester/mcp-unity"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "unity-3",
      "command": "TODO",
      "args": [
        "See README: https://github.com/CoderGamester/mcp-unity"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "unity-3": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/CoderGamester/mcp-unity"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add unity-3 -- TODO 'See README: https://github.com/CoderGamester/mcp-unity'

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: mcp-unity

Como construir uma cena simples a partir do chat com o mínimo de cerimônia

👤 Desenvolvedores Unity indie ⏱ ~15 min beginner

Quando usar: Você quer um MCP Unity sem 100+ ferramentas ocupando seu contexto.

Pré-requisitos

Unity 6 ou posterior — unity.com/download
Node 18+ — nodejs.org ou nvm
Instalar pacote a partir da URL git — Gerenciador de Pacotes > + > Adicionar a partir da URL git: https://github.com/CoderGamester/mcp-unity.git

Fluxo

Compor uma cena

Crie uma nova cena 'Playground'. Adicione um Plane, uma Luz Direcional e 3 cubos nas posições (-2,0,0), (0,0,0), (2,0,0).✓ Copiado

→ Cena aparece, objetos visíveis
Conectar interações

Adicione um Rigidbody e BoxCollider a cada cubo. Torne o cubo na origem cinemático.✓ Copiado

→ Componentes visíveis na inspeção
Executar testes

run_tests mode=EditMode. Mostre as falhas.✓ Copiado

→ Saída do teste

Resultado: Uma cena funcionando + testes passando, tudo no chat.

Armadilhas

O comportamento de rollback do batch_execute varia — não é uma transação real — Assuma sucesso parcial em caso de erro; verifique após o lote

Combine com: github

Como criar e instanciar prefabs a partir do chat

👤 Desenvolvedores Unity construindo ativos reutilizáveis ⏱ ~15 min intermediate

Quando usar: Você quer que o agente mantenha uma biblioteca de prefabs.

Fluxo

Criar um prefab

Crie um GameObject 'Enemy' com componente Rigidbody + EnemyAI, depois create_prefab a partir dele em Assets/Prefabs/Enemy.prefab.✓ Copiado

→ Arquivo Prefab criado
Instanciar

add_asset_to_scene Assets/Prefabs/Enemy.prefab em 5 posições aleatórias dentro de 50 unidades da origem.✓ Copiado

→ 5 inimigos colocados

Resultado: Um prefab Enemy reutilizável + 5 instâncias colocadas.

Como iterar sobre uma correção com run_tests em um loop apertado

👤 Desenvolvedores Unity com cobertura de testes ⏱ ~15 min intermediate

Quando usar: Bug + teste existe; quer refatoração rápida red-green.

Fluxo

Ver a falha

run_tests mode=EditMode filter='EnemyAI_ShouldPatrol'. Mostre a pilha.✓ Copiado

→ Asserção falhando com linha
Editar e reteste

Aplique a correção mínima, salve e execute novamente o teste.✓ Copiado

→ Teste verde

Resultado: Teste verde, confiança na correção.

Combine com: github

Combinações

Combine com outros MCPs para 10× de alavancagem

unity-3 + github

Executar testes, depois fazer commit + PR da correção

Corrija a falha do teste EnemyAI, faça commit no branch fix/enemy-patrol, abra um PR.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
create_scene	name: str	Iniciar uma nova cena	free
load_scene	path: str	Abrir cena existente	free
get_gameobject	name_or_id: str	Procurar um objeto	free
update_gameobject	id, props	Renomear, reparentar, alternar ativo	free
update_component	target, component, values	Ajustar campos de componentes	free
create_prefab	source_id, path	Capturar um objeto como prefab	free
add_asset_to_scene	path, position?, rotation?	Instanciar um ativo/prefab	free
run_tests	mode: 'EditMode'\|'PlayMode', filter?	Testes unitários	free
get_console_logs	since_ms?	Verificar erros	free
batch_execute	calls: Call[]	Compor várias chamadas de ferramenta	free

Custo e limites

O que custa rodar

Cota de API: Nenhuma — apenas local
Tokens por chamada: Pequeno; este MCP tem uma lista de ferramentas compacta
Monetário: Grátis (código aberto)
Dica: Agrupe operações relacionadas via batch_execute para reduzir viagens de ida e volta.

Segurança

Permissões, segredos, alcance

Escopos mínimos: Apenas acesso ao projeto local

Armazenamento de credenciais: Nenhuma

Saída de dados: Localhost; LLM vê tudo o que sua ferramenta retorna

Nunca conceda: Exponha a ponte Node para não-loopback

Testes PlayMode executam código do jogo — efeitos colaterais possíveis. Faça commit primeiro.

Solução de problemas

Erros comuns e correções

Unity 'pacote não pôde ser resolvido'

Requer Unity 6 ou posterior. Verifique a versão; a instalação da URL git falha em editores mais antigos.

A ponte Node trava na inicialização

Requer Node 18 + npm 9. Verifique 'node -v' e atualize.

Verificar: node -v

Testes não aparecem

Os assemblies de teste devem ser definidos em arquivos de Definição de Assembly que fazem referência ao TestRunner.

Alternativas

mcp-unity vs. outros

Alternativa	Quando usar	Troca
MCP for Unity (CoplayDev)	Você quer a maior superfície de ferramentas Unity com cobertura de física/VFX	Mais ferramentas = mais custo de contexto
Unity-MCP (IvanMurzak)	Você precisa de execução C# única com suporte Roslyn	Mais poder, mais risco

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills