Repolode
Enviar
CoderGamester

CoderGamester/mcp-unity

Plugin do Model Context Protocol (MCP) que permite a assistentes de programação com IA, como Cursor, Claude Code e Codex, controlar e consultar o Unity Editor.

Ver no GitHub
Estrelas
1,943
Forks
247
Issues abertas
7
Último commit
há 8 dias

O que é?

MCP Unity conecta o Unity Editor a um servidor Node.js que implementa o Model Context Protocol. Um servidor WebSocket roda dentro do Editor, e o lado do Node.js encaminha para o Unity as solicitações de clientes de IA como Cursor, Windsurf, Claude Code, Codex CLI, GitHub Copilot e OpenCode.

Depois de conectado, um assistente de IA pode executar itens de menu, criar e atualizar GameObjects e componentes, mover ou girar objetos, gerenciar cenas e prefabs, editar materiais, instalar pacotes, executar testes pelo Unity Test Runner e ler logs do console. O plugin também disponibiliza recursos para consultar a hierarquia da cena, os assets, os pacotes e as listas de testes, além de uma ferramenta em lote para executar várias operações em uma única solicitação.

O pacote é instalado pelo Unity Package Manager usando uma URL do git. É possível gerar a configuração em uma janela do servidor no Editor, com opções locais ao projeto ou globais. A instalação de pacotes e a inicialização em batch mode ficam desativadas por padrão por segurança, e a conexão é protegida por um token de autenticação exclusivo de cada projeto.

Recursos principais

  • 01Disponibiliza operações de GameObject, componentes, transform e materiais para assistentes de IA.
  • 02Executa itens de menu do Unity e testes EditMode/PlayMode pelo Test Runner.
  • 03Lê logs do console, a hierarquia da cena, assets e pacotes instalados como recursos MCP.
  • 04Controla o carregamento, salvamento e descarregamento de cenas, além do estado do play mode.
  • 05Permite executar várias operações em lote em uma única solicitação.
  • 06Gera configurações de cliente para Cursor, Claude Code, Codex CLI, Copilot e OpenCode.

Casos de uso

  • Permitir que um assistente de programação com IA configure objetos de cena, prefabs e materiais a partir de descrições em linguagem natural.
  • Executar testes do Unity em uma conversa com IA e consultar as falhas no console.
  • Criar ou renomear vários GameObjects em lote, sem precisar clicar manualmente no Editor.
  • Ajudar colegas a se familiarizarem com um projeto Unity desconhecido consultando a hierarquia da cena e os assets.

Início rápido

  1. 1

    Instale o Node.js 18 ou posterior pela página de downloads do Node.js

  2. 2

    Instale o pacote Unity MCP Server pelo Unity Package Manager (Window > Package Manager)

  3. 3

    Verifique se o Node.js está instalado

    node --version

Antes de usar

  • Requer Unity 6 ou posterior e Node.js 18 ou posterior.
  • Caminhos de projeto com espaços podem causar problemas de conexão.

Tópicos

#mcp#unity#game-development#ai-agent#csharp#editor-automation#model-context-protocol#claudecode#codex-cli#copilot

Perguntas frequentes

O que é mcp-unity?
Plugin do Model Context Protocol (MCP) que permite a assistentes de programação com IA, como Cursor, Claude Code e Codex, controlar e consultar o Unity Editor. MCP Unity conecta o Unity Editor a um servidor Node.js que implementa o Model Context Protocol. Um servidor WebSocket roda dentro do Editor, e o lado do Node.js encaminha para o Unity as solicitações de clientes de IA como Cursor, Windsurf, Claude Code, Codex CLI, GitHub Copilot e OpenCode.
mcp-unity é gratuito? Qual é a licença?
mcp-unity é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
mcp-unity ainda é mantido?
Manutenção ativa. O último commit de mcp-unity foi em 11 de out. de 2026.
Para que posso usar mcp-unity?
Permitir que um assistente de programação com IA configure objetos de cena, prefabs e materiais a partir de descrições em linguagem natural. Executar testes do Unity em uma conversa com IA e consultar as falhas no console. Criar ou renomear vários GameObjects em lote, sem precisar clicar manualmente no Editor. Ajudar colegas a se familiarizarem com um projeto Unity desconhecido consultando a hierarquia da cena e os assets.
Como instalar mcp-unity?
Instale o Node.js 18 ou posterior pela página de downloads do Node.js Instale o pacote Unity MCP Server pelo Unity Package Manager (Window > Package Manager) Verifique se o Node.js está instalado: node --version
Onde consigo mcp-unity?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/CoderGamester/mcp-unity

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados