MCP Unreal Server

by radial-hks
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Facilitates executing Python code remotely within Unreal Engine instances, supporting multiple execution modes including file execution and statement evaluation.

  • Enables remote Python code execution in Unreal Engine environments, supporting both attended and unattended execution modes, file execution, and statement evaluation through an automatic node discovery system.

MCP 虚幻服务器

通过远程 Python 执行与虚幻引擎实例交互的服务器实现。

特征

  • 🚀虚幻实例管理
    • 通过多播自动发现虚幻节点
    • 实时节点状态监控
    • 通过 LSP 兼容客户端列出资源
  • 💻远程执行
    • 在虚幻引擎环境中执行 Python 代码
    • 支持有人值守和无人值守的执行模式
    • 文件执行和语句评估模式
  • 📊日志记录和监控
    • 详细记录到文件( mcp_unreal.log
    • 具有不同详细程度的控制台日志记录
    • 节点连接健康监控

安装

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

配置

网络设置

RemoteExecutionConfig中配置多播参数:

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

日志记录

修改server.py中的日志配置:

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

用法

启动服务器

python -m src.mcp_server_unreal.server

支持的工具

  1. 连接到虚幻实例
{ "host": "239.0.0.1", "port": 6766 }
  1. 执行 Python 代码
{ "node_id": "<unreal-node-id>", "code": "print('Hello Unreal')", "unattended": true }

API 文档

资源格式

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

执行模式

模式描述
模式执行文件执行 Python 文件
模式执行语句执行 Python 语句
模式评估语句计算 Python 表达式

故障排除

常见问题:

  • 未发现节点:验证虚幻实例是否正在使用 MCP 插件运行
  • 执行超时:检查防火墙设置中的多播流量
  • 连接断开:监视mcp_unreal.log以了解节点状态变化

执照

Apache-2.0许可证

-
security - not tested
F
license - not found
-
quality - not tested

一种服务器实现,可在虚幻引擎环境中实现远程 Python 代码执行,具有通过多播网络自动发现和管理虚幻节点的功能。

  1. Features
    1. Installation
      1. Configuration
        1. Network Settings
        2. Logging
      2. Usage
        1. Starting the Server
        2. Supported Tools
      3. API Documentation
        1. Resource Format
        2. Execution Modes
      4. Troubleshooting
        1. License
          ID: xptd5hcrir