[!IMPORTANT] Union está obsoleto. Utiliza el servidor MCP oficial de Unity.

Union ♾️ - El servidor MCP de Unity

Un servidor del Protocolo de Contexto de Modelo (MCP) para Unity

Características clave

• 🖼️ Visión multimodal: Tu agente puede ver lo que tú ves. Puede visualizar la escena, mirar a través de cualquier cámara, observar el modo de juego e inspeccionar miniaturas de activos.

• 🔎 Búsqueda potente: Ve más allá del panel de proyecto con búsquedas simultáneas en la jerarquía y en los activos del proyecto.

• ✔️ Análisis de código superior: Aprovecha el propio compilador de Unity para un análisis de código más preciso que el linter de tu agente.

• ⏩ Inicio rápido: Empieza a trabajar en segundos con un único archivo de configuración mcp.json.

• 🛠️ Extensible: Añade tus propias herramientas específicas para el proyecto con un mínimo de código repetitivo.

• 📅 Siempre actualizado: Mantenido al día con la última versión del protocolo MCP — actualmente 2025-06-18 a través del SDK oficial de C# para MCP.

Related MCP server: Unity MCP Server

Compatibilidad

Configuración

1. Instalar node.js

2. Configurar mcp.json

{
  "mcpServers": {
    "unity": {
      "command": "npx",
      "args": ["-y", "@nurture-tech/unity-mcp-runner", "-unityPath", "<path to unity editor>", "-projectPath", "<path to unity project>"]
    }
  }
}

Esto instalará automáticamente el paquete is.nurture.mcp en tu proyecto de Unity. Siéntete libre de confirmar esos cambios en el control de versiones.

Acerca de las herramientas

Conoce tu caja de herramientas de IA para Unity.

Problemas conocidos

• El Google External Dependency Manager (EDMU) provoca que Unity se bloquee indefinidamente al iniciarse cuando se lanza a través de Cursor en Windows. Esto está bajo investigación.

• La herramienta test_active_scene a veces falla con el mensaje de error Maximum call stack size exceeded.

• La herramienta search falla ocasionalmente con el mensaje de error Search index is not ready yet. Please try again later.

Añadir herramientas específicas del proyecto

Union utiliza el SDK oficial de C# para MCP.

1. Crea una clase estática para albergar tus herramientas. Añade la anotación [McpServerToolType] a la clase.

2. Declara métodos estáticos para implementar cada herramienta. Añade la anotación [McpServerTool] a cada método.

3. Consulta el directorio Services para ver ejemplos.

4. Probablemente necesitarás cerrar Unity y reiniciar tu agente para que pueda ver las nuevas herramientas.

Consejos de uso

Aquí tienes algunos consejos para sacar el máximo provecho de Union:

• 🚀 Lanza a través de tu agente: Lanza siempre Unity a través de la integración MCP de tu agente de IA. Lanzar Unity desde el Hub impedirá que el servidor MCP se conecte.

• 📂 Configuración por proyecto: Si tu agente lo admite, configura el servidor MCP en tus ajustes por proyecto. Esto te permite cambiar sin problemas entre proyectos de Unity.

• ⚙️ Argumentos de línea de comandos: Puedes pasar argumentos adicionales a Unity para escenarios avanzados como ejecutar en -batchmode o -nographics para tuberías de CI/CD. Añade un separador -- antes de los argumentos específicos de Unity:

  {
    "mcpServers": {
      "unity": {
        "command": "npx",
        "args": [
          "-y",
          "@nurture-tech/unity-mcp-runner"
          "-unityPath",
          "<path to unity editor>",
          "-projectPath",
          ".",
          "--",
          "-batchmode",
          "-nographics"
        ]
      }
    }
  }

• ⚠️ Importante: No utilices el argumento de línea de comandos -logFile. El servidor MCP depende de la salida estándar de Unity para la comunicación.

• 🖥️ Pantalla dividida para visión: Para herramientas como screenshot, asegúrate de que el editor de Unity esté visible en tu pantalla, de lo contrario terminará capturando la ventana en primer plano.