Plugin para Unity Editor y runtime, y servidor MCP que permite a agentes de IA como Claude, Cursor y Copilot operar proyectos de Unity y ejecutar LLMs dentro de juegos.
CoderGamester/mcp-unity
Un plugin de Model Context Protocol (MCP) que permite a asistentes de programación con IA como Cursor, Claude Code y Codex controlar y consultar Unity Editor.
- Estrellas
- 1,943
- Forks
- 247
- Issues abiertos
- 7
- Último commit
- hace 9 días
¿Qué es?
MCP Unity conecta Unity Editor con un servidor Node.js que implementa Model Context Protocol. Dentro del Editor se ejecuta un servidor WebSocket, y el componente de Node.js reenvía a Unity las solicitudes de clientes de IA como Cursor, Windsurf, Claude Code, Codex CLI, GitHub Copilot y OpenCode.
Una vez establecida la conexión, un asistente de IA puede ejecutar elementos de menú; crear y actualizar GameObjects y componentes; mover o rotar objetos; gestionar escenas y prefabs; editar materiales; instalar paquetes; ejecutar pruebas de Unity Test Runner y leer los logs de la consola. También ofrece recursos para consultar la jerarquía de la escena, los assets, los paquetes y las listas de pruebas, además de una herramienta por lotes para ejecutar varias operaciones en una sola solicitud.
El paquete se instala desde Unity Package Manager mediante una URL de Git. La configuración se puede generar desde una ventana del servidor en el Editor, con opciones locales al proyecto o globales. La instalación de paquetes y el inicio en modo batch están desactivados de forma predeterminada por seguridad, y la conexión está protegida por un token de autenticación exclusivo de cada proyecto.
Funciones clave
- 01Expone a los asistentes de IA operaciones con GameObjects, componentes, transforms y materiales.
- 02Ejecuta elementos de menú de Unity y pruebas de EditMode/PlayMode mediante Test Runner.
- 03Permite consultar logs de la consola, la jerarquía de la escena, los assets y los paquetes instalados como recursos MCP.
- 04Controla la carga, el guardado y la descarga de escenas, así como el estado del modo de juego.
- 05Permite ejecutar por lotes varias operaciones en una sola solicitud.
- 06Genera configuraciones de cliente para Cursor, Claude Code, Codex CLI, Copilot y OpenCode.
Casos de uso
- Permitir que un asistente de programación con IA configure objetos de escena, prefabs y materiales a partir de descripciones en lenguaje natural.
- Ejecutar pruebas de Unity desde un chat con IA y consultar los errores en la consola.
- Crear o cambiar el nombre de muchos GameObjects por lotes, sin tener que hacer clic manualmente en el Editor.
- Ayudar a los compañeros a familiarizarse con un proyecto de Unity desconocido mediante consultas sobre la jerarquía de escenas y los assets.
Inicio rápido
- 1
Instala Node.js 18 o una versión posterior desde la página de descargas de Node.js
- 2
Instala el paquete Unity MCP Server mediante Unity Package Manager (Window > Package Manager)
- 3
Comprueba que Node.js esté instalado
node --version
Antes de usarlo
- Se requiere Unity 6 o una versión posterior y Node.js 18 o una versión posterior.
- Las rutas de proyecto que contienen espacios pueden causar problemas de conexión.
Temas
Preguntas frecuentes
- ¿Qué es mcp-unity?
- Un plugin de Model Context Protocol (MCP) que permite a asistentes de programación con IA como Cursor, Claude Code y Codex controlar y consultar Unity Editor. MCP Unity conecta Unity Editor con un servidor Node.js que implementa Model Context Protocol. Dentro del Editor se ejecuta un servidor WebSocket, y el componente de Node.js reenvía a Unity las solicitudes de clientes de IA como Cursor, Windsurf, Claude Code, Codex CLI, GitHub Copilot y OpenCode.
- ¿mcp-unity es gratuito? ¿Qué licencia tiene?
- mcp-unity es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿mcp-unity sigue mantenido?
- Mantenimiento activo. El último commit de mcp-unity fue el 11 oct 2026.
- ¿Para qué puedo usar mcp-unity?
- Permitir que un asistente de programación con IA configure objetos de escena, prefabs y materiales a partir de descripciones en lenguaje natural. Ejecutar pruebas de Unity desde un chat con IA y consultar los errores en la consola. Crear o cambiar el nombre de muchos GameObjects por lotes, sin tener que hacer clic manualmente en el Editor. Ayudar a los compañeros a familiarizarse con un proyecto de Unity desconocido mediante consultas sobre la jerarquía de escenas y los assets.
- ¿Cómo se instala mcp-unity?
- Instala Node.js 18 o una versión posterior desde la página de descargas de Node.js Instala el paquete Unity MCP Server mediante Unity Package Manager (Window > Package Manager) Comprueba que Node.js esté instalado: node --version
- ¿Dónde consigo mcp-unity?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/CoderGamester/mcp-unity
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
Un puente que permite a asistentes de IA como Claude, Cursor o VS Code controlar el Editor de Unity mediante el Model Context Protocol.
Un servidor MCP que permite a agentes de IA abrir el editor de Godot, ejecutar proyectos, capturar la salida de depuración y gestionar escenas.
Integración de async/await sin asignaciones para Unity que permite esperar a AsyncOperations, coroutines y eventos, y se ejecuta en PlayerLoop sin hilos.
Consola de juego basada en uGUI para Unity que muestra logs durante la ejecución y permite ejecutar comandos de depuración registrados en las builds.
Plugin con licencia MIT para Unreal Engine 5.8 o posterior que amplía el servidor MCP nativo para que agentes de IA controlen el editor en distintos ámbitos.