/ Directorio / Playground / Unity-MCP
● Comunidad IvanMurzak ⚡ Instantáneo

Unity-MCP

por IvanMurzak · IvanMurzak/Unity-MCP

Bucle completo de desarrollo y pruebas impulsado por IA para Unity con 100+ herramientas, ejecución de C# respaldada por Roslyn y CLI para configuración rápida.

IvanMurzak/Unity-MCP es un plugin de Unity + servidor MCP que expone una amplia superficie (escenas, GameObjects, componentes, prefabs, materiales, paquetes, capturas de pantalla, pruebas, ejecución de C# con Roslyn) a cualquier cliente MCP. Enfatiza la eficiencia de tokens y una capa de Habilidades IA encima de herramientas brutas.

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

unity-2.replay ▶ listo
0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "unity-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/IvanMurzak/Unity-MCP"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "unity-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/IvanMurzak/Unity-MCP"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "unity-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/IvanMurzak/Unity-MCP"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "unity-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/IvanMurzak/Unity-MCP"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "unity-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/IvanMurzak/Unity-MCP"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json
{
  "context_servers": {
    "unity-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/IvanMurzak/Unity-MCP"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add unity-2 -- TODO 'See README: https://github.com/IvanMurzak/Unity-MCP'

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Unity-MCP

Cómo procesar por lotes assets importados con un único prompt

👤 Artistas técnicos de Unity ⏱ ~25 min intermediate

Cuándo usarlo: Tienes 200 texturas nuevas y deseas configuración de importación consistente, mapas de mips y colocación en atlas.

Requisitos previos
  • Proyecto de Unity abierto, plugin instalado — unity-mcp-cli install-plugin ./MyUnityProject o importar el .unitypackage
  • Cliente MCP configurado — Apunta Claude Desktop o Cursor al servidor MCP local impreso por la CLI
Flujo
  1. Auditar configuración actual
    Lista cada textura en Assets/Textures/UI. Muestra la configuración actual de TextureImporter agrupada por los valores utilizados.✓ Copiado
    → Grupos por configuración — principalmente consistentes con valores atípicos marcados
  2. Aplicar una política
    Para todos ellos, establece compression=HighQuality, filter=Bilinear, mipmaps=false. Reimportar.✓ Copiado
    → Registro de progreso + estado final consistente
  3. Verificar visualmente
    Toma una captura de pantalla de la escena MainMenu desde la cámara predeterminada — confirma que nada se ve roto.✓ Copiado
    → Captura de pantalla devuelta, verificación de cordura aprobada

Resultado: Configuración de importación uniforme en una carpeta + un registro de capturas de pantalla.

Errores comunes
  • La reimportación bloquea la recarga del dominio del editor — Guarda la escena primero; no emitas comandos no relacionados hasta que se complete la reimportación
Combinar con: filesystem

Cómo ejecutar un fragmento de C# único en el Editor sin escribir un script

👤 Desarrolladores de Unity haciendo limpieza desechable ⏱ ~15 min advanced

Cuándo usarlo: Deseas iterar a través de cada prefab y corregir una referencia rota — una sola vez.

Flujo
  1. Describir el fragmento
    Ejecuta C# a través de Roslyn: itera cada prefab bajo Assets/Prefabs, encuentra componentes MissingScript, lista el prefab + guid del script faltante.✓ Copiado
    → Informe de prefabs dañados
  2. Aplicar la corrección
    Ahora elimina esos componentes MissingScript y guarda cada prefab.✓ Copiado
    → Recuento de prefabs actualizado

Resultado: Un proyecto libre de advertencias de scripts faltantes.

Errores comunes
  • La ejecución de Roslyn tiene poder completo del editor — un fragmento malo puede corromper el proyecto — Realiza un commit en git antes de ejecutar; revisa el fragmento de código antes de ejecutar
Combinar con: github

Cómo hacer triaje de una regresión visual mediante capturas de pantalla

👤 QA, desarrolladores en solitario ⏱ ~10 min beginner

Cuándo usarlo: Un tester dice 'el menú se ve mal' y deseas una imagen de referencia rápidamente.

Flujo
  1. Abrir la escena sospechosa
    Abre la escena MainMenu y toma una captura de pantalla desde la cámara de UI a 1920x1080.✓ Copiado
    → Ruta de archivo de captura de pantalla devuelta
  2. Comparar con una referencia
    Aquí está la imagen de referencia [adjuntar]. Describe las diferencias.✓ Copiado
    → Señalamientos específicos (desplazamientos, colores, elementos faltantes)

Resultado: Un informe de error con evidencia de imagen adjunta.

Combinar con: github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

unity-2 + github

Automatizar refactores + commit + PR desde chat

Renombra el campo PlayerController.Speed a MoveSpeed en todas partes, ejecuta pruebas, realiza commit y abre un PR.✓ Copiado
unity-2 + filesystem

Importar modelos 3D externos al proyecto

Mueve cada .fbx de ~/Downloads/kenney/ a Assets/Models/ y establécelos como lectura/escritura deshabilitada.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
scene_open path: str Carga una escena antes de inspección o ediciones free
gameobject_find query: str Localizar objetos free
component_add target, type, values? Adjuntar componentes free
script_create path, body Nuevo archivo C# free
csharp_execute code: str Automatización única del editor free
test_run mode: 'Edit'|'Play', filter? Ejecutar pruebas unitarias/juego free
screenshot camera?: str, resolution?: {w,h} Verificación visual free
console_read since_ms? Verificar errores después de cambios free

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
Sin API remota — todo local
Tokens por llamada
Los listados de escenas pueden crecer mucho; limita con filtros
Monetario
Gratuito, código abierto
Consejo
Prefiere consultas estrechas (gameobject_find 'Enemy*') sobre volcados de jerarquía completa.

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Escritura de sistema de archivos local en el proyecto
Almacenamiento de credenciales: Ninguno — solo localhost
Salida de datos: Localhost. Tu proveedor de LLM recibe cualquier contenido de escena/script que devuelve la herramienta.
No conceder nunca: No expongas el puerto MCP HTTP a interfaces no loopback

Resolución de problemas

Errores comunes y soluciones

La ruta del proyecto contiene espacios: herramientas fallan

Mueve el proyecto a una ruta sin espacios. Esta es una limitación documentada.

CLI no puede encontrar Unity

Establece la variable de entorno UNITY_EDITOR_PATH en el binario del editor.

Verificar: $UNITY_EDITOR_PATH -version
csharp_execute lanza 'tipo no encontrado'

Unity debe haber compilado con éxito antes de la ejecución. Arregla la consola roja primero y actualiza.

Alternativas

Unity-MCP vs otros

AlternativaCuándo usarlaContrapartida
MCP for Unity (CoplayDev)Deseas la opción más popular con una gran superficie de herramientasSin ejecución arbitraria de C# basada en Roslyn
mcp-unity (CoderGamester)Superficie más simple enfocada en escenas/pruebasMenos herramientas avanzadas

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills