Ivan Murzak

Unity MCP (Servidor + Complemento)

Versión de Unity	Modo de edición	Modo de juego	Autónomo
2022.3.61f1
2023.2.20f1
6000.0.46f1

Unity-MCP es un puente entre LLM y Unity. Expone y explica a LLM las herramientas de Unity. LLM comprende la interfaz y utiliza las herramientas según las necesidades del usuario.

Conecte Unity-MCP a un cliente LLM, como Claude o Cursor , mediante la ventana integrada AI Connector . También se admiten clientes personalizados.

El proyecto está diseñado para que los desarrolladores puedan añadir herramientas personalizadas próximamente. Posteriormente, el objetivo es habilitar las mismas funciones en la compilación del jugador. Por el momento, solo funciona en el Editor de Unity.

El sistema es extensible: puedes definir tool personalizadas directamente en el código base de tu proyecto Unity, lo que expone nuevas capacidades a los clientes de IA o automatización. Esto convierte a Unity-MCP en una base flexible para crear flujos de trabajo avanzados, prototipado rápido o integrar funciones basadas en IA en tu proceso de desarrollo.

Herramientas de IA

Objeto de juego

• ✅ Crear
• ✅ Destruir
• ✅ Encuentra
• ✅ Modificar (etiqueta, capa, nombre, estático)
• ✅ Establecer padre
• ✅ Duplicado

GameObject.Componentes

• ✅ Agregar componente
• ✅ Obtener componentes
• ✅ Modificar componente
• • ✅ Valor del conjunto Field
• • ✅ Valor establecido Property
• • ✅ Conjunto de enlaces Reference
• ✅ Destruir componente
• 🔲 Eliminar los componentes faltantes

Editor

• ✅ Estado (Modo de juego)
  • ✅ Obtener
  • ✅ Conjunto
• ✅ Obtener Windows
• ✅ Capa
  • ✅ Consiguelo todo
  • ✅ Agregar
  • ✅ Eliminar
• ✅ Etiqueta
  • ✅ Consiguelo todo
  • ✅ Agregar
  • ✅ Eliminar
• ✅ Ejecutar MenuItem
• 🔲 Ejecutar pruebas

Selección del editor

• ✅ Obtenga selección
• ✅ Selección de conjuntos

Prefabricados

• ✅ Instanciar
• 🔲 Crear
• ✅ Abierto
• ✅ Modificar (GameObject.Modify)
• ✅ Ahorrar
• ✅ Cerrar

Paquete

• 🔲 Instalalo
• 🔲Instalar
• 🔲 Eliminar
• 🔲 Actualización

Activos

• ✅ Crear
• ✅ Encuentra
• ✅ Actualizar
• ✅ Leer
• ✅ Modificar
• ✅ Cambiar nombre
• ✅ Eliminar
• ✅ Muévete
• ✅ Crear carpeta

Escena

• ✅ Crear
• ✅ Ahorra
• ✅ Cargar
• ✅ Descargar
• ✅ Cargate
• ✅ Obtener jerarquía
• 🔲 Buscar (editor)
• 🔲 Raycast (entender el volumen)

Materiales

• ✅ Crear
• ✅ Modificar (Activos.Modificar)
• ✅ Leer (Activos.Leer)
• ✅ Asignar a un componente en un GameObject

Sombreador

• ✅ Listar todo

Guiones

• ✅ Leer
• ✅ Actualizar o crear
• ✅ Eliminar

Objeto programable

• 🔲 Crear
• 🔲 Leer
• 🔲 Modificar
• 🔲 Eliminar

Depurar

• 🔲 Leer registros (consola)

Componente

• ✅ Consiguelo todo

Leyenda: ✅ = Implementado y disponible, 🔲 = Planificado / Aún no implementado

Instalación

1. Instalar .NET 9.0
2. Instalar OpenUPM-CLI

• Abrir la línea de comandos en la carpeta del proyecto de Unity
• Ejecutar el comando

Uso

1. Asegúrese de que la ruta de su proyecto no tenga un símbolo de espacio " ".

• ✅ C:/MyProjects/Project
• ❌ C:/My Projects/Project

2. Abra el proyecto Unity, vaya a 👉 Window/AI Connector (Unity-MCP) .

3. Instalar el cliente MCP

• Instalar Cursor (recomendado)
• Instalar Claude

4. Iniciar sesión en el cliente MCP
5. Haga clic en Configure en su cliente MCP.

6. Reinicie su cliente MCP.
7. Asegúrese de que AI Connector esté "Conectado" o "Conectando..." después de reiniciar.
8. Prueba la conexión de IA en tu cliente (Cursor, Claude Desktop). Escribe cualquier pregunta o tarea en el chat. Algo como esto:

Agregar tool personalizada

⚠️ Solo funciona con el cliente MCP que admite la actualización dinámica de la lista de herramientas.

Unity-MCP está diseñado para facilitar el desarrollo de tool personalizadas por parte del propietario del proyecto. El servidor MCP toma datos del plugin de Unity y los expone a un cliente. De esta forma, cualquier persona en la cadena de comunicación de MCP recibirá información sobre una nueva tool , a la que LLM podría llamar en algún momento.

Para agregar una tool personalizada necesitas:

1. Tener una clase con atributo McpPluginToolType .
2. Tener un método en la clase con atributo McpPluginTool .
3. [opcional] Agregue el atributo Description a cada argumento del método para permitir que LLM lo comprenda.
4. [opcional] Utilice string? optional = null propiedades con ? y el valor predeterminado para marcarlas como optional para LLM.

Observa que la línea MainThread.Run(() => permite ejecutar el código en el hilo principal, necesario para interactuar con la API de Unity. Si no lo necesitas y ejecutar la herramienta en segundo plano funciona bien, no uses el hilo principal por cuestiones de eficiencia.

Agregar tool personalizada en el juego

⚠️ Aún no disponible. El trabajo está en curso.

Contribución

Siéntete libre de agregar nuevas tool al proyecto.

1. Bifurcar el proyecto.
2. Implemente una nueva tool en su repositorio bifurcado.
3. Cree una solicitud de extracción en el repositorio Unity-MCP original.