Servidor Unreal de MCP

Una implementación de servidor para interactuar con instancias de Unreal Engine a través de la ejecución remota de Python.

Características

🚀 Gestión de instancias de Unreal
- Descubrimiento automático de nodos de Unreal mediante multidifusión
- Monitoreo del estado del nodo en tiempo real
- Listado de recursos a través de clientes compatibles con LSP
Ejecución remota
- Ejecutar código Python en entornos de Unreal Engine
- Admite modos de ejecución asistidos y no asistidos
- Modos de ejecución de archivos y evaluación de sentencias
📊 Registro y monitoreo
- Registro detallado en archivo ( mcp_unreal.log )
- Registro de consola con diferentes niveles de verbosidad
- Monitoreo del estado de la conexión del nodo

Related MCP server: Unity MCP Integration

Instalación

# Clone repository git clone https://github.com/your-org/mcp-unreal-server.git cd mcp-unreal-server # Install dependencies pip install -r requirements.txt

Configuración

Configuración de red

Configurar parámetros de multidifusión en RemoteExecutionConfig :

# Default multicast settings (modify in server.py) config.multicast_group_endpoint = ("239.0.0.1", 6766)

Explotación florestal

Modificar la configuración de registro en server.py :

# Adjust log levels file_handler.setLevel(logging.DEBUG) # File logging console_handler.setLevel(logging.INFO) # Console logging

Uso

Iniciando el servidor

python -m src.mcp_server_unreal.server

Herramientas compatibles

Conectarse a una instancia de Unreal

{ "host": "239.0.0.1", "port": 6766 }

Ejecutar código Python

{ "node_id": "<unreal-node-id>", "code": "print('Hello Unreal')", "unattended": true }

Documentación de la API

Formato de recursos

types.Resource( uri="unreal://<node_id>", name=f"Unreal Instance: {node_id}", description="Unreal Engine instance", mimeType="application/x-unreal" )

Modos de ejecución

Modo	Descripción
MODO_EJECUTAR_ARCHIVO	Ejecutar archivo Python
DECLARACIÓN DE MODO DE EJECUCIÓN	Ejecutar declaración de Python
DECLARACIÓN DE EVALUACIÓN DE MODO	Evaluar una expresión de Python

Solución de problemas

Problemas comunes:

No se detectaron nodos: verifique que las instancias de Unreal se estén ejecutando con el complemento MCP
Tiempo de espera de ejecución: verifique la configuración del firewall para el tráfico de multidifusión
Caídas de conexión: supervise mcp_unreal.log para detectar cambios en el estado del nodo