Repolode
IvanMurzak

IvanMurzak/Unity-MCP

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.

Estrellas
4,497
Forks
399
Issues abiertos
59
Último commit
ayer

¿Qué es?

Unity-MCP es un plugin y servidor MCP que conecta agentes de IA como Claude Code, Claude Desktop, Cursor, GitHub Copilot y Gemini con Unity Editor. Una vez instalado, un agente puede inspeccionar la jerarquía de la escena, crear y modificar GameObjects y componentes, gestionar assets, prefabs y escenas, leer la consola, controlar el modo de juego, tomar capturas de pantalla y ejecutar pruebas de Unity.

Además de automatizar el editor, el proyecto incluye un paquete runtime que permite que un juego compilado exponga sus propios métodos como herramientas MCP, para que los LLMs controlen comportamientos dentro del juego, como las decisiones de los NPC o un bot de ajedrez. Los desarrolladores pueden añadir herramientas personalizadas anotando un método de C# con un atributo. El plugin también genera archivos de AI skills según la versión de Unity del proyecto y los paquetes instalados.

La instalación está disponible mediante un paquete instalador, OpenUPM o la herramienta de línea de comandos unity-mcp-cli. El servidor puede ejecutarse localmente mediante stdio o de forma remota mediante HTTP transmitible, incluso en Docker.

Funciones clave

  • 01Permite que los agentes de IA lean y modifiquen escenas, GameObjects, componentes y assets en Unity Editor.
  • 02Ofrece más de 70 herramientas MCP integradas para gestionar assets, escenas, scripting, la consola y el profiling.
  • 03Compila y ejecuta código C# en runtime mediante Roslyn.
  • 04Ejecuta lógica controlada por LLMs dentro de juegos compilados mediante un paquete runtime.
  • 05Admite herramientas personalizadas definidas mediante la anotación de métodos de C#.
  • 06Funciona mediante stdio local o HTTP transmitible remoto, y ofrece imágenes de Docker.

Casos de uso

  • Pedir a un agente de IA que cree distribuciones de escenas, prefabs y materiales a partir de instrucciones en lenguaje natural.
  • Permitir que un agente de IA ejecute pruebas de Unity e inspeccione errores de la consola mientras depura un proyecto.
  • Añadir un NPC o bot del juego controlado por un LLM dentro de un juego de Unity publicado.
  • Automatizar tareas del editor en un proyecto de equipo mediante la CLI y un servidor alojado en Docker.

Inicio rápido

  1. 1

    Instala Node CLI de forma global

    npm install -g unity-mcp-cli
  2. 2

    Instala el plugin en tu proyecto de Unity

    unity-mcp-cli install-plugin ./MyUnityProject
  3. 3

    Inicia sesión en ai-game.dev desde el navegador

    unity-mcp-cli login
  4. 4

    Abre el proyecto de Unity para conectarlo automáticamente y generar skills

    unity-mcp-cli open ./MyUnityProject

Antes de usarlo

  • Se necesita un proyecto de Unity, ya que es un plugin para Unity Editor y el entorno de ejecución.
  • La configuración rápida con CLI requiere iniciar sesión en el servicio ai-game.dev mediante OAuth.

Temas

Preguntas frecuentes

¿Qué es Unity-MCP?
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. Unity-MCP es un plugin y servidor MCP que conecta agentes de IA como Claude Code, Claude Desktop, Cursor, GitHub Copilot y Gemini con Unity Editor. Una vez instalado, un agente puede inspeccionar la jerarquía de la escena, crear y modificar GameObjects y componentes, gestionar assets, prefabs y escenas, leer la consola, controlar el modo de juego, tomar capturas de pantalla y ejecutar pruebas de Unity.
¿Unity-MCP es gratuito? ¿Qué licencia tiene?
Unity-MCP es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Unity-MCP sigue mantenido?
Mantenimiento activo. El último commit de Unity-MCP fue el 19 oct 2026.
¿Para qué puedo usar Unity-MCP?
Pedir a un agente de IA que cree distribuciones de escenas, prefabs y materiales a partir de instrucciones en lenguaje natural. Permitir que un agente de IA ejecute pruebas de Unity e inspeccione errores de la consola mientras depura un proyecto. Añadir un NPC o bot del juego controlado por un LLM dentro de un juego de Unity publicado. Automatizar tareas del editor en un proyecto de equipo mediante la CLI y un servidor alojado en Docker.
¿Cómo se instala Unity-MCP?
Instala Node CLI de forma global: npm install -g unity-mcp-cli Instala el plugin en tu proyecto de Unity: unity-mcp-cli install-plugin ./MyUnityProject Inicia sesión en ai-game.dev desde el navegador: unity-mcp-cli login Abre el proyecto de Unity para conectarlo automáticamente y generar skills: unity-mcp-cli open ./MyUnityProject
¿Dónde consigo Unity-MCP?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/IvanMurzak/Unity-MCP

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados