Repolode
CoderGamester

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. 1

    Instala Node.js 18 o una versión posterior desde la página de descargas de Node.js

  2. 2

    Instala el paquete Unity MCP Server mediante Unity Package Manager (Window > Package Manager)

  3. 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