Inicio rapido

June 8, 2026 · View on GitHub

Unity MCP — CLI

Herramienta CLI multiplataforma para Unity MCP — crea proyectos, instala plugins, configura herramientas MCP e inicia Unity con conexiones MCP activas. Todo desde una sola linea de comandos.

:white_check_mark: Crear proyectos — crea nuevos proyectos de Unity mediante el Editor de Unity
:white_check_mark: Instalar editores — instala cualquier version del Editor de Unity desde la linea de comandos
:white_check_mark: Instalar plugin — agrega el plugin Unity-MCP a manifest.json con todos los registros de ambito requeridos
:white_check_mark: Eliminar plugin — elimina el plugin Unity-MCP de manifest.json
:white_check_mark: Configurar — activa/desactiva herramientas, prompts y recursos MCP
:white_check_mark: Verificar estado — visualiza el proceso de Unity, servidor local y conexion al servidor en la nube de un vistazo
:white_check_mark: Ejecutar herramientas — ejecuta herramientas MCP directamente desde la linea de comandos
:white_check_mark: Configurar MCP — escribe archivos de configuracion MCP para agentes de IA en cualquiera de los 14 agentes soportados
:white_check_mark: Configurar habilidades — genera archivos de habilidades para agentes de IA a traves del servidor MCP
:white_check_mark: Esperar disponibilidad — sondea hasta que Unity Editor y el servidor MCP esten conectados y acepten llamadas de herramientas
:white_check_mark: Abrir y conectar — inicia Unity con variables de entorno MCP opcionales para la conexion automatica al servidor
:white_check_mark: Multiplataforma — Windows, macOS y Linux
:white_check_mark: Compatible con CI — detecta automaticamente terminales no interactivas y desactiva spinners/colores
:white_check_mark: Modo detallado — usa --verbose en cualquier comando para obtener salida de diagnostico detallada
:white_check_mark: Control de versiones — nunca degrada versiones del plugin, resuelve la ultima version desde OpenUPM

AI Game Developer — Unity SKILLS and MCP

Inicio rapido

Instala globalmente y ejecuta:

# 1.1 Install unity-mcp-cli                                #  ┌────────────────────┐
npm install -g unity-mcp-cli                               #  │ Available AI agent │
                                                           #  ├────────────────────┤
# 1.2 (Optional) Install Unity                             #  │ antigravity        │
unity-mcp-cli install-unity                                #  │ claude-code        │
                                                           #  │ claude-desktop     │
# 1.3 (Optional) Create Unity project                      #  │ cline              │
unity-mcp-cli create-project ./MyUnityProject              #  │ codex              │
                                                           #  │ cursor             │
# 2. Install "AI Game Developer" in Unity project          #  │ gemini             │
unity-mcp-cli install-plugin ./MyUnityProject              #  │ github-copilot-cli │
                                                           #  │ kilo-code          │
# 3. Login to cloud server                                 #  │ open-code          │
unity-mcp-cli login ./MyUnityProject                       #  │ rider-junie        │
                                                           #  │ unity-ai           │
# 4. Open Unity project (auto-connects and generates skills)  │ vs-copilot         │
unity-mcp-cli open ./MyUnityProject                        #  │ vscode-copilot     │
                                                           #  └────────────────────┘
# 5. Wait for Unity Editor to be ready
unity-mcp-cli wait-for-ready ./MyUnityProject

O ejecuta cualquier comando al instante con npx — sin necesidad de instalacion global:

npx unity-mcp-cli install-plugin /path/to/unity/project

Requisitos: Node.js ^20.19.0 || >=22.12.0. Unity Hub se instala automaticamente si no se encuentra.

AI Game Developer — Unity SKILLS and MCP

Contenidos

Inicio rapido
Contenidos
Comandos
Ejemplo de automatizacion completa
Como funciona

AI Game Developer — Unity SKILLS and MCP

Comandos

Opcion	Requerido	Descripcion
`[path]`	Si	Ruta donde se creara el proyecto (posicional o `--path`)
`--unity <version>`	No	Version del Editor de Unity a utilizar (por defecto, la mas alta instalada)

`install-plugin`

Instala el plugin Unity-MCP en el archivo Packages/manifest.json de un proyecto de Unity.

unity-mcp-cli install-plugin ./MyGame

Opcion	Requerido	Descripcion
`[path]`	Si	Ruta al proyecto de Unity (posicional o `--path`)
`--plugin-version <version>`	No	Version del plugin a instalar (por defecto, la ultima desde OpenUPM)

Este comando:

Agrega el registro de ambito de OpenUPM con todos los ambitos requeridos
Agrega com.ivanmurzak.unity.mcp a dependencies
Nunca degrada — si ya hay instalada una version superior, se conserva

Ejemplo — instalar una version especifica del plugin:

unity-mcp-cli install-plugin ./MyGame --plugin-version 0.51.6

Despues de ejecutar este comando, abre el proyecto en el Editor de Unity para completar la instalacion del paquete.

AI Game Developer — Unity SKILLS and MCP

Argumento / Opcion	Requerido	Descripcion
`[version]`	No	Version del Editor de Unity a instalar (ej. `6000.3.1f1`)
`--path <path>`	No	Lee la version requerida desde un proyecto existente

Opcion	Variable de entorno	Requerido	Descripcion
`[path]`	—	Si	Ruta al proyecto de Unity (posicional o `--path`)
`--unity <version>`	—	No	Version especifica del Editor de Unity a utilizar (por defecto, la version de la configuracion del proyecto; si no esta disponible, la mas alta instalada)
`--no-connect`	—	No	Abrir sin variables de entorno de conexion MCP
`--url <url>`	`UNITY_MCP_HOST`	No	URL del servidor MCP al que conectarse
`--keep-connected`	`UNITY_MCP_KEEP_CONNECTED`	No	Fuerza mantener la conexion activa
`--token <token>`	`UNITY_MCP_TOKEN`	No	Token de autenticacion
`--auth <option>`	`UNITY_MCP_AUTH_OPTION`	No	Modo de autenticacion: `none` o `required`
`--tools <names>`	`UNITY_MCP_TOOLS`	No	Lista de herramientas a activar, separadas por comas
`--transport <method>`	`UNITY_MCP_TRANSPORT`	No	Metodo de transporte: `streamableHttp` o `stdio`
`--start-server <value>`	`UNITY_MCP_START_SERVER`	No	Establece `true` o `false` para controlar el inicio automatico del servidor MCP

Ejecuta una herramienta MCP directamente a traves de la API HTTP. La URL del servidor y el token de autorizacion se resuelven automaticamente desde el archivo de configuracion del proyecto (UserSettings/AI-Game-Developer-Config.json), basandose en el modo de conexion actual (Custom o Cloud).

unity-mcp-cli run-tool gameobject-create ./MyGame --input '{"name":"Cube"}'

Opcion	Requerido	Descripcion
`<tool-name>`	Si	Nombre de la herramienta MCP a ejecutar
`[path]`	No	Ruta al proyecto de Unity (posicional o `--path`) — se usa para leer la configuracion y detectar el puerto
`--url <url>`	No	URL directa del servidor (omite la configuracion)
`--token <token>`	No	Token Bearer (omite la configuracion)
`--input <json>`	No	Cadena JSON con los argumentos de la herramienta (por defecto `{}`)
`--input-file <file>`	No	Lee los argumentos JSON desde un archivo
`--raw`	No	Salida JSON sin formato (sin formato visual, sin spinner)
`--timeout <ms>`	No	Tiempo de espera de la solicitud en milisegundos (por defecto: 60000)

Prioridad de resolucion de URL:

--url → se usa directamente
Archivo de configuracion → host (modo Custom) o URL de nube predefinida (modo Cloud)
Puerto determinista a partir de la ruta del proyecto

La autorizacion se lee automaticamente desde la configuracion del proyecto (token en modo Custom, cloudToken en modo Cloud). Usa --token para reemplazar explicitamente el token derivado de la configuracion.

Ejemplo — llamar a una herramienta (URL y autenticacion desde la configuracion):

unity-mcp-cli run-tool gameobject-find ./MyGame --input '{"query":"Player"}'

Ejemplo — URL explicita:

unity-mcp-cli run-tool scene-save --url http://localhost:8080

Ejemplo — redirigir salida JSON sin formato:

unity-mcp-cli run-tool assets-list ./MyGame --raw | jq '.results'

AI Game Developer — Unity SKILLS and MCP

`wait-for-ready`

Espera hasta que Unity Editor y el servidor MCP esten conectados y listos para aceptar llamadas de herramientas. Sondea el servidor a un intervalo configurable hasta que responda correctamente o se alcance el tiempo limite. Util para scripts de automatizacion y orquestacion de agentes de IA donde open inicia Unity pero el agente necesita saber cuando puede empezar a llamar herramientas.

unity-mcp-cli wait-for-ready ./MyGame

Opcion	Requerido	Descripcion
`[path]`	No	Ruta al proyecto de Unity (posicional o `--path`) — se usa para leer la configuracion y detectar el puerto
`--url <url>`	No	URL directa del servidor (omite la configuracion)
`--token <token>`	No	Token Bearer (omite la configuracion)
`--timeout <ms>`	No	Tiempo maximo de espera en milisegundos (por defecto: 120000)
`--interval <ms>`	No	Intervalo de sondeo en milisegundos (por defecto: 3000)

Ejemplo — esperar con timeout por defecto (120s):

unity-mcp-cli open ./MyGame
unity-mcp-cli wait-for-ready ./MyGame
unity-mcp-cli run-tool tests-run ./MyGame --input '{"testMode":"EditMode"}'

Ejemplo — timeout mas corto para CI:

unity-mcp-cli wait-for-ready ./MyGame --timeout 60000 --interval 2000

Ejemplo — URL explicita del servidor:

unity-mcp-cli wait-for-ready --url http://localhost:8080 --timeout 30000

AI Game Developer — Unity SKILLS and MCP

`setup-mcp`

Escribe archivos de configuracion MCP para agentes de IA, permitiendo la configuracion headless/CI sin la interfaz del Editor de Unity. Soporta los 14 agentes (Claude Code, Cursor, Gemini, Codex, etc.).

unity-mcp-cli setup-mcp claude-code ./MyGame

Opcion	Requerido	Descripcion
`[agent-id]`	Si	Agente a configurar (usa `--list` para ver todos)
`[path]`	No	Ruta al proyecto de Unity (por defecto, el directorio actual)
`--transport <transport>`	No	Metodo de transporte: `stdio` o `http` (por defecto: `http`)
`--url <url>`	No	URL del servidor (para transporte http)
`--token <token>`	No	Token de autenticacion
`--list`	No	Lista todos los IDs de agentes disponibles

Ejemplo — listar todos los agentes soportados:

unity-mcp-cli setup-mcp --list

Ejemplo — configurar Cursor con transporte stdio:

unity-mcp-cli setup-mcp cursor ./MyGame --transport stdio

AI Game Developer — Unity SKILLS and MCP

`setup-skills`

Genera archivos de habilidades para un agente de IA llamando a la API de herramientas del sistema del servidor MCP. Requiere que el Editor de Unity este en ejecucion con el plugin MCP instalado.

unity-mcp-cli setup-skills claude-code ./MyGame

Opcion	Requerido	Descripcion
`[agent-id]`	Si	Agente para el que generar habilidades (usa `--list` para ver todos)
`[path]`	No	Ruta al proyecto de Unity (por defecto, el directorio actual)
`--url <url>`	No	URL del servidor
`--token <token>`	No	Token de autenticacion
`--list`	No	Lista todos los agentes con el estado de soporte de habilidades
`--timeout <ms>`	No	Tiempo de espera de la solicitud en milisegundos (por defecto: 60000)

Ejemplo — listar agentes con soporte de habilidades:

unity-mcp-cli setup-skills --list

AI Game Developer — Unity SKILLS and MCP

`remove-plugin`

Elimina el plugin Unity-MCP del archivo Packages/manifest.json de un proyecto de Unity.

unity-mcp-cli remove-plugin ./MyGame

Opcion	Requerido	Descripcion
`[path]`	Si	Ruta al proyecto de Unity (posicional o `--path`)

Este comando:

Elimina com.ivanmurzak.unity.mcp de dependencies
Conserva los registros de ambito y sus ambitos — otros paquetes pueden depender de ellos
No realiza ninguna accion si el plugin no esta instalado

Despues de ejecutar este comando, abre el proyecto en el Editor de Unity para aplicar el cambio.

AI Game Developer — Unity SKILLS and MCP

`status`

Verifica el estado de conexion del Unity Editor y el servidor MCP. Muestra si Unity esta en ejecucion, si el servidor MCP local esta accesible y si el servidor configurado (ej. nube) esta accesible.

unity-mcp-cli status ./MyGame

Opcion	Requerido	Descripcion
`[path]`	No	Ruta al proyecto de Unity (posicional o `--path`)
`--url <url>`	No	URL directa del servidor (omite la configuracion)
`--token <token>`	No	Token Bearer (omite la configuracion)
`--timeout <ms>`	No	Tiempo de espera del sondeo en milisegundos (por defecto: 5000)

AI Game Developer — Unity SKILLS and MCP

Opciones globales

Estas opciones estan disponibles en todos los comandos:

Opcion	Descripcion
`-v, --verbose`	Activa la salida de diagnostico detallada para resolucion de problemas
`--version`	Muestra la version de la CLI
`--help`	Muestra la ayuda del comando

Ejemplo — ejecutar cualquier comando con salida detallada:

unity-mcp-cli install-plugin ./MyGame --verbose

AI Game Developer — Unity SKILLS and MCP

Ejemplo de automatizacion completa

Configura un proyecto Unity MCP completo desde cero con un solo script:

# 1. Create a new Unity project
unity-mcp-cli create-project ./MyAIGame --unity 6000.3.1f1

# 2. Install the Unity-MCP plugin
unity-mcp-cli install-plugin ./MyAIGame

# 3. Enable all MCP tools
unity-mcp-cli configure ./MyAIGame --enable-all-tools

# 4. Login to cloud server (authenticates and saves token)
unity-mcp-cli login ./MyAIGame

# 5. Open the project (auto-connects and generates skills for claude-code)
unity-mcp-cli open ./MyAIGame

# 6. Wait for Unity Editor and MCP server to be ready
unity-mcp-cli wait-for-ready ./MyAIGame

# 7. Run tests to verify everything works
unity-mcp-cli run-tool tests-run ./MyAIGame --input '{"testMode":"EditMode"}'

AI Game Developer — Unity SKILLS and MCP

Como funciona

Puerto determinista

La CLI genera un puerto determinista para cada proyecto de Unity basandose en la ruta de su directorio (hash SHA256 mapeado al rango de puertos 20000–29999). Esto coincide con la generacion de puertos del plugin de Unity, garantizando que el servidor y el plugin acuerden automaticamente el mismo puerto sin necesidad de configuracion manual.

Instalacion del plugin

El comando install-plugin modifica Packages/manifest.json directamente:

Agrega el registro de ambito de OpenUPM (package.openupm.com)
Registra todos los ambitos requeridos (com.ivanmurzak, extensions.unity)
Agrega la dependencia com.ivanmurzak.unity.mcp con actualizaciones que respetan la version (nunca degrada)

Archivo de configuracion

El comando configure lee y escribe UserSettings/AI-Game-Developer-Config.json, que controla:

Tools — herramientas MCP disponibles para los agentes de IA
Prompts — prompts predefinidos inyectados en las conversaciones con el LLM
Resources — datos de solo lectura expuestos a los agentes de IA
Connection settings — URL del host, token de autenticacion, metodo de transporte, tiempos de espera

Integracion con Unity Hub

Los comandos que gestionan editores o crean proyectos usan la CLI de Unity Hub (modo --headless). Si Unity Hub no esta instalado, la CLI lo descarga e instala automaticamente:

Windows — instalacion silenciosa mediante UnityHubSetup.exe /S (puede requerir privilegios de administrador)
macOS — descarga el DMG, lo monta y copia Unity Hub.app en /Applications
Linux — descarga UnityHub.AppImage en ~/Applications/

Para la documentacion completa del proyecto Unity-MCP, consulta el README principal.

AI Game Developer — Unity SKILLS and MCP

Opcion	Requerido	Descripcion
`[path]`	Si	Ruta al proyecto de Unity (posicional o `--path`)
`--list`	No	Muestra la configuracion actual y termina
`--enable-tools <names>`	No	Activa herramientas especificas (separadas por comas)
`--disable-tools <names>`	No	Desactiva herramientas especificas (separadas por comas)
`--enable-all-tools`	No	Activa todas las herramientas
`--disable-all-tools`	No	Desactiva todas las herramientas
`--enable-prompts <names>`	No	Activa prompts especificos (separados por comas)
`--disable-prompts <names>`	No	Desactiva prompts especificos (separados por comas)
`--enable-all-prompts`	No	Activa todos los prompts
`--disable-all-prompts`	No	Desactiva todos los prompts
`--enable-resources <names>`	No	Activa recursos especificos (separados por comas)
`--disable-resources <names>`	No	Desactiva recursos especificos (separados por comas)
`--enable-all-resources`	No	Activa todos los recursos
`--disable-all-resources`	No	Desactiva todos los recursos

Inicio rapido

Unity MCP — CLI

Inicio rapido

Contenidos

Comandos

`configure`

`create-project`

`install-plugin`

`install-unity`

`open`

`run-tool`

`wait-for-ready`

`setup-mcp`

`setup-skills`

`remove-plugin`

`status`

Opciones globales

Ejemplo de automatizacion completa

Como funciona

Puerto determinista

Instalacion del plugin

Archivo de configuracion

Integracion con Unity Hub