Unity Biome MCP

Controla el Editor de Unity desde clientes MCP o desde el chat dentro de Unity: más de 70 herramientas para escenas, GameObjects, componentes, assets, Shader Graph, DSL de PlayTest, capturas de pantalla con comparación visual, operaciones por lotes y protocolo eficiente en tokens. Más de 11 700 pruebas, CI multiplataforma, Asistente de configuración para 10 clientes.

GitHub
25
Prueba este MCPPatrocinado

Documentación

Unity Biome MCP

Concept illustration of an AI client sending a live MCP signal through Unity Biome MCP to the Unity Editor

Controla el Editor de Unity desde clientes de IA compatibles con MCP o desde el chat dentro de Unity.

Inspecciona escenas, edita GameObjects, ejecuta pruebas de juego y captura resultados mediante herramientas estructuradas.


Documentation MIT license Latest release

Python CI C# Linux EditMode C# macOS EditMode C# Windows EditMode

Python coverage C# coverage Tool quality score

Registered MCP tools Discovered test inventory unity-biome-mcp MCP server

Inicio rápido · Documentación · Comparación · Registro de cambios

Inicio rápido

Requisitos: Unity 6 (6000.0 o posterior), Git 2.14+ en PATH, y uv. El servidor MCP no necesita una instalación de Python separada cuando se ejecuta a través de uvx; la sincronización opcional de habilidades de Codex requiere Python 3.10 o posterior en PATH. Consulta los requisitos previos de Primeros pasos.

1. Instalar uv

macOS y Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

winget install astral-sh.uv

2. Agregar el paquete de Unity

  1. En Unity, abre Window > Package Manager.
  2. Selecciona + > Add package from git URL.
  3. Introduce:
https://github.com/german-krasnikov/unity-biome-mcp.git?path=unity-plugin

3. Configurar tu cliente

Abre MCP > Setup Wizard, elige un cliente y sigue el resultado que muestra el Wizard.

La configuración depende del cliente. El Wizard puede escribir una configuración de proyecto, ejecutar el asistente de configuración, copiar un fragmento específico del cliente o diferir la configuración hasta que se inicie In-Unity Chat. Reinicia el cliente seleccionado cuando se te indique. El Wizard configura la integración; no realiza una prueba de conexión de extremo a extremo.

Guías de configuración manual del cliente

Usa la guía correspondiente:

Claude Code | Claude Desktop | Codex | Cursor | Junie | Kimi | OpenCode | Rider AI Assistant | VS Code | Windsurf

Para la configuración externa de OpenCode, no uses el JSON estándar del portapapeles del Wizard: OpenCode tiene una forma de configuración diferente. Sigue la guía de OpenCode.

4. Verificar la primera conexión

Para un cliente MCP externo, mantén abierto el proyecto de Unity, reinicia el cliente si el Wizard te lo pidió y envía:

Lee la jerarquía de la escena activa de Unity a profundidad 2 y resume sus objetos raíz.

El cliente debería llamar:

get_hierarchy(depth=2)

Una respuesta exitosa contiene la jerarquía de la escena activa. Si la llamada falla, abre MCP > Status > Diagnose en Unity. Para la verificación solo con Chat, usa la verificación rápida de Chat. Para diagnósticos de línea de comandos, ejecuta:

uvx --from git+https://github.com/german-krasnikov/unity-biome-mcp.git#subdirectory=server unity-biome-mcp doctor

Consulta Primeros pasos para pasos de recuperación y detalles de la plataforma.

Instalación de desarrollo local

Requisitos para una copia del código fuente: Git y Python 3.10 o posterior.

git clone https://github.com/german-krasnikov/unity-biome-mcp.git
cd unity-biome-mcp
python install.py setup
python install.py configure --tool claude-code
python install.py doctor

El asistente de configuración admite claude-code, claude-desktop, cursor, windsurf, vscode, codex, kimi, junie y opencode.

Documentación

ObjetivoGuía
Instalar y conectarPrimeros pasos
Elegir y configurar un cliente MCPGuías de cliente
Instalar guía de IA local al proyectoHabilidades y agentes de IA
Encontrar una herramienta para una tareaGuía de herramientas
Usar lotes de forma seguraOperaciones por lotes
Crear flujos de trabajo de Play ModePlayTest DSL
Configurar In-Unity ChatBackends de Chat
Extender Unity Biome MCPInicio rápido de plugins
Diagnosticar fallosDiagnósticos

Lo que puedes hacer

  • Edición de escenas y objetos: inspecciona y modifica GameObjects, componentes, assets, materiales, shaders y UI.
  • Pruebas de juego y verificación: ejecuta flujos de trabajo de PlayTest DSL, comprobaciones de compilación, comprobaciones de consola, diagnósticos de tiempo de ejecución y comparaciones visuales.
  • Animación y VFX: trabaja con clips, controladores de Animator, Timeline, partículas, materiales, shaders y Shader Graph.
  • Uso eficiente de herramientas: agrupa operaciones compatibles con batch, solicita esquemas diferidos y habilita categorías de capacidades solo cuando sea necesario.
  • Extensibilidad: agrega herramientas de servidor específicas del proyecto, comandos de Unity, chips de contexto de Chat y enlaces de plugins.
Ejemplos de prompts y lotes

Ejemplos de prompts:

Crea un objeto de jugador, agrega un Rigidbody y colócalo en el origen de la escena.

Encuentra enemigos sin colliders y agrega un BoxCollider a cada uno.

Ejecuta una prueba de juego que mueva al jugador a la puerta y verifique que la puntuación aumente.

Captura la Game View y compárala con la línea base guardada.

Resume los cambios de escena desde el último punto de control.

Ejemplo de lote

Usa batch para dos o más operaciones compatibles:

batch(commands="""
create_object name=Enemy
set_property path=Enemy component=Transform prop=position value=0,1,0
manage_component path=Enemy type=Rigidbody action=add
set_property path=Enemy component=Rigidbody prop=mass value=2
""")

Algunas herramientas tipadas son solo directas y no se pueden colocar en un lote. Consulta la guía de lotes para validación, reversión respaldada por Undo y manejo de errores.

Formas de trabajar

Cliente MCP externo

Un cliente MCP lanza el servidor Python a través de stdio. El servidor descubre el proyecto de Unity activo y envía comandos enmarcados al plugin del editor a través de TCP localhost.

In-Unity Chat

Abre MCP > Chat para trabajar dentro del editor. Selecciona un backend CLI compatible y usa el modo Ask o Agent. La autenticación la maneja el CLI seleccionado. Los chips de contexto pueden adjuntar objetos de escena, scripts y assets a un turno, mientras que cada turno de IA completado se agrupa para el deshacer de Unity.

Consulta Backends de Chat para configuración y comportamiento.

Arquitectura

Animated architecture diagram: external clients and In-Unity Chat reach the Python MCP server and Unity Editor plugin through their local transport paths

La ruta externa es MCP client -> Python MCP server -> localhost TCP -> Unity Editor plugin. In-Unity Chat invoca al CLI seleccionado a través del relay de chat local; ese CLI se conecta al mismo servidor MCP de Python y se reincorpora a la ruta compartida de TCP a plugin.

Habilidades de IA

El paquete de Unity incluye 12 habilidades de dominio reutilizables y 4 agentes enfocados para Claude Code y Codex. Cubren selección eficiente de herramientas MCP, agrupación en lotes, creación de contenido en Unity, pruebas de juego, diagnósticos y verificación basada en evidencia.

Abre MCP > Install AI Skills para instalarlas en el proyecto actual. Los archivos existentes y generados se verifican en cuanto a propiedad antes de reemplazarlos. Consulta Habilidades y agentes de IA para rutas, actualizaciones seguras y sincronización de Codex.

Inventario del proyecto

Los valores a continuación se generan a partir de registros, recopilación de pytest, descubrimiento de pruebas de Unity o escaneo de código fuente, y metadatos de paquetes. Son recuentos de descubrimiento, no una afirmación de que cada prueba se ejecutó en la copia actual.

160 registered MCP tools. Test inventory: 13925 entries: 5603 regular Python, 511 Python stress, 444 live Python, and 7367 Unity source attributes. Unity count source: static source scan. Server package version: v1.39.0.

Comparación de productos Unity MCP

Verificado el 16 de agosto de 2026:

  • Unity Biome MCP: 160 herramientas registradas, PlayTest DSL determinista y flujos de trabajo de línea base/diff visuales.
  • Unity MCP Server 2.17: puente local de primera parte, aprobación de conexión y soporte para múltiples clientes.
  • MCP for Unity 10.1.2: compatibilidad con Unity 2021.3, 47 puntos de entrada de herramientas y alojamiento remoto autenticado.
  • AI Game Developer 0.87.0: tiempo de ejecución de jugador compilado más implementación local, HTTP, nube y Docker.
  • MCP Unity: 33 herramientas listadas, reversión opcional de Undo para lotes y un panel de MCP App.

La matriz detallada cita commits exactos de código fuente o documentación oficial versionada y registra tanto limitaciones como fortalezas.

Abrir la comparación completa respaldada por código fuente

Cambios recientes

Versión actual: v1.39.0 (2026-08-17). Lee el registro de cambios completo.

Contribuciones

Lee CONTRIBUTING.md antes de abrir una solicitud de extracción. Los nuevos contribuyentes pueden comenzar con buenos primeros problemas.

Reporta problemas de seguridad a través de SECURITY.md.

Licencia

MIT