AI导哈

虚幻引擎远程执行服务

MCP Unreal Server是一个通过远程Python执行与Unreal Engine实例交互的服务，提供实例管理、远程执行和日志监控功能。

  • by radial-hks
  • HTML
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 radial-hks/MCP-Unreal-Server

使用说明

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"
)

执行模式

模式 描述
MODE_EXEC_FILE 执行Python文件
MODE_EXEC_STATENT 执行Python语句
MODE_EVAL_STATENT 计算Python表达式

故障排除

常见问题：

  • 未发现节点：验证虚幻实例是否使用MCP插件运行
  • 执行超时：检查多播流量的防火墙设置
  • 连接中断：监视器 mcp_unreal.log 用于节点状态更改

许可证

Apache-2.0许可证

相关 MCP