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

1. Conectarse a una instancia de Unreal

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

2. 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

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

Licencia

Licencia Apache-2.0