CommunityPesquisa e Análise de Dadosgithub.com

CoplayDev/unity-mcp

O Unity MCP atua como uma ponte, permitindo que assistentes de IA (como Claude, Cursor) interajam diretamente com seu Editor Unity por meio de um cliente MCP (Model Context Protocol) local. Dê à sua LLM ferramentas para gerenciar ativos, controlar cenas, editar scripts e automatizar tarefas dentro do Unity.

O que é unity-mcp?

O Unity MCP é uma skill que estabelece uma conexão entre assistentes de IA (como Claude, Cursor) e o Editor Unity, utilizando o Model Context Protocol (MCP). Ele permite que modelos de linguagem (LLMs) executem ações diretamente no Unity, como gerenciar ativos, controlar cenas, editar scripts e automatizar tarefas repetitivas, sem a necessidade de intervenção manual constante. A skill é compatível com diversas plataformas, incluindo Claude Desktop, Claude Code, Cursor e assistentes que suportam MCP, como o 5ire. Para usá-la, é necessário instalar o Node.js e configurar o caminho do executável do Unity no Ambiente de Trabalho ou no arquivo de configuração do MCP. O funcionamento é baseado em ferramentas registradas no servidor MCP, como 'get_scene_hierarchy', 'get_game_object_details', 'execute_menu_action', e 'create_script_component', que permitem à IA ler a hierarquia de cenas, obter detalhes de objetos, executar comandos de menu e criar componentes de script. Essa integração acelera o desenvolvimento de jogos, especialmente em fluxos de trabalho que exigem iteração rápida e automação de tarefas rotineiras no Unity.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add CoplayDev/unity-mcp

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Ver original→Navegar por todas as habilidades

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentação

O que unity-mcp faz?

O Unity MCP atua como uma ponte, permitindo que assistentes de IA (como Claude, Cursor) interajam diretamente com seu Editor Unity por meio de um cliente MCP (Model Context Protocol) local. Dê à sua LLM ferramentas para gerenciar ativos, controlar cenas, editar scripts e automatizar tarefas dentro do Unity.

Funcionalidades

  • Gerenciamento de Cena: Obter hierarquia de cena, detalhes de objetos do jogo, desinstalar cenas
  • Manipulação de Objetos: Criar/destruir objetos do jogo, modificar transformações, adicionar/remover componentes
  • Operações de Script: Criar scripts, ler conteúdo de scripts, modificar scripts
  • Ações de Menu: Executar ações de menu do Unity (Ctrl+D, Ctrl+S, Ctrl+Z, etc.)
  • Seleção: Obter/gameobjects selecionados atualmente, definir objeto de jogo ativo
  • Gerenciamento de Assets: Criar pastas, importar assets, criar prefabs
  • Automação de Build: Build player, limpar cache, log de console

Configuração

Pré-requisitos

  • Node.js (v18+)
  • Unity Editor
  • Ambiente de trabalho compatível com MCP (Claude Desktop, Claude Code, Cursor)

Instalação Rápida

  1. Instale o node.js (se ainda não estiver instalado)

    Baixe em https://nodejs.org/ ou use um gerenciador de pacotes:

    • macOS: brew install node
    • Windows: Baixe o instalador
    • Linux: apt install nodejs npm

  2. Obtenha o caminho do executável do Unity

    Certifique-se de saber o caminho completo para o executável do Unity (por exemplo, /Applications/Unity/Hub/Editor/6000.0.29f1/Unity.app/Contents/MacOS/Unity no macOS ou C:\Program Files\Unity\Hub\Editor\6000.0.29f1\Editor\Unity.exe no Windows).

  3. Configure a chave de API

    Para se comunicar com o Editor Unity, você precisa de uma chave de API gerada pelo Unity MCP. Execute:

    npx github.com/coplaydev/unity-mcp --generate-key

    Copie a chave gerada (ela será necessária na configuração).

  4. Adicione ao seu Ambiente de Trabalho MCP

    Claude Desktop (arquivo claude_desktop_config.json):

    {
  "mcpServers": {
    "unity-mcp": {
      "command": "npx",
      "args": [
        "github.com/coplaydev/unity-mcp"
      ],
      "env": {
        "UNITY_EDITOR_PATH": "/Applications/Unity/Hub/Editor/6000.0.29f1/Unity.app/Contents/MacOS/Unity",
        "UNITY_MCP_API_KEY": "SuaChaveGeradaAqui",
        "UNITY_PROJECT_PATH": "/Caminho/para/seu/projeto/unity"
      }
    }
  }
}

    Cursor (configuração. MCP):

    {
  "unity-mcp": {
    "command": "npx",
    "args": [
      "github.com/coplaydev/unity-mcp"
    ],
    "env": {
      "UNITY_EDITOR_PATH": "/Applications/Unity/Hub/Editor/6000.0.29f1/Unity.app/Contents/MacOS/Unity",
      "UNITY_MCP_API_KEY": "SuaChaveGeradaAqui",
      "UNITY_PROJECT_PATH": "/Caminho/para/seu/projeto/unity"
    }
  }
}

    Claude Code:

    npx github.com/coplaydev/unity-mcp

Variáveis de Ambiente

VariávelDescriçãoPadrão
UNITY_EDITOR_PATHCaminho para o executável do Unity(obrigatório)
UNITY_PROJECT_PATHCaminho para o projeto Unity(obrigatório)
UNITY_MCP_API_KEYChave de API para comunicação com o Unity(obrigatório)
UNITY_MCP_PORTPorta para o servidor HTTP no Unity8765
UNITY_MCP_TIMEOUTTempo limite de resposta em segundos60
UNITY_MCP_LOG_LEVELNível de log (debug, info, warn, error)info

Uso

Uma vez configurado, você pode pedir ao seu assistente de IA para realizar tarefas no Unity:

"Liste todos os objetos do jogo na cena atual" "Crie um cubo na posição (0, 2, 0)" "Adicione um componente Rigidbody ao objeto selecionado" "Crie um script C# chamado PlayerController" "Execute Ctrl+D para duplicar o objeto selecionado" "Build o projeto para Windows"

Nota: O Editor Unity deve estar aberto e executando o servidor MCP Unity. Certifique-se de que o Unity MCP está em execução no seu projeto Unity.

Ferramentas

Ferramentas de Cena

  • get_scene_hierarchy - Obtém a hierarquia completa da cena atual
  • get_game_object_details - Obtém detalhes de um objeto do jogo específico
  • unload_scene - Descarrega uma cena específica

Ferramentas de Manipulação de Objetos

  • create_game_object - Cria um novo objeto do jogo
  • destroy_game_object - Destrói um objeto do jogo
  • set_active_game_object - Define o estado ativo de um objeto do jogo
  • modify_transform - Modifica a transformação de um objeto do jogo (posição, rotação, escala)
  • add_component - Adiciona um componente a um objeto do jogo
  • remove_component - Remove um componente de um objeto do jogo

Ferramentas de Script

  • create_script - Cria um novo script C#
  • get_script_content - Obtém o conteúdo de um script
  • modify_script - Modifica um script existente

Ferramentas de Ações de Menu

  • execute_menu_action - Executa uma ação de menu do Unity (por exemplo, "Ctrl+D", "Ctrl+S", "Ctrl+Z")

Ferramentas de Seleção

  • get_selected_objects - Obtém os objetos atualmente selecionados
  • set_selected_game_object - Define o objeto de jogo ativo/selecionado

Ferramentas de Asset

  • create_folder - Cria uma nova pasta no projeto
  • import_asset - Importa um asset para o projeto
  • refresh_assets - Atualiza a janela de assets do projeto
  • create_prefab - Cria um prefab a partir de um objeto do jogo

Ferramentas de Build

  • build_player - Build o projeto para uma plataforma específica
  • get_build_settings - Obtém as configurações atuais de build
  • set_build_settings - Define configurações de build
  • clean_cache - Limpa o cache do Unity
  • get_console_log - Obtém logs do console do Unity

Ações de Menu Disponíveis

  • Ctrl+S - Salvar cena atual
  • Ctrl+Z - Desfazer
  • Ctrl+Shift+Z - Refazer
  • Ctrl+D - Duplicar
  • Ctrl+C - Copiar
  • Ctrl+V - Colar
  • Ctrl+X - Recortar
  • Ctrl+A - Selecionar tudo
  • Delete - Deletar ativos
  • Shift+Delete - Deletar ativos permanentemente
  • Ctrl+F - Buscar no projeto ou na hierarquia
  • Ctrl+P - Reproduzir
  • Ctrl+Shift+P - Pausar
  • Ctrl+Alt+P - Avançar um frame
  • F5 - Atualizar a janela do projeto
  • Ctrl+B - Build settings
  • Ctrl+Shift+B - Build player

Recursos Úteis

Exemplo de Workflow Típico

  1. Abra seu projeto Unity
  2. Certifique-se de que o servidor Unity MCP esteja em execução (configurado no seu ambiente de trabalho)
  3. Peça ao seu assistente de IA para:
    • "Mostre a hierarquia da cena"
    • "Crie um GameObject vazio chamado 'Inimigo' na posição (10, 0, 5)"
    • "Adicione um componente BoxCollider a ele"
    • "Crie um script C# chamado 'MovimentoInimigo'"
    • "Modifique o script para incluir uma função de movimento básico"
  4. A IA executará cada comando diretamente no seu Editor Unity

Compatibilidade de Plataformas

  • Claude Desktop ✅
  • Claude Code ✅
  • Cursor ✅
  • 5ire ✅
  • Outros clientes MCP ✅

Licença

MIT

Habilidades Relacionadas

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

community

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

community

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

community

affaan-m/everything-claude-code

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

community

forrestchang/andrej-karpathy-skills

Agent skill repository discovered by 10x-chat research.

community

langgenius/backend-code-review

Review backend code for quality, security, maintainability, and best practices based on established checklist rules. Use when the user requests a review, analysis, or improvement of backend files (e.g., `.py`) under the `api/` directory. Do NOT use for frontend files (e.g., `.tsx`, `.ts`, `.js`). Supports pending-change review, code snippets review, and file-focused review.

community
← More Pesquisa e Análise de Dados skills