Unreal Engine Remote Execution

🚀 MCP Unreal 服务器

MCP Unreal 服务器实现了与 Unreal Engine 实例通过远程 Python 执行进行交互的功能，为开发者提供了便捷的操作体验。

🚀 快速开始

MCP Unreal 服务器可实现与 Unreal Engine 实例的远程 Python 交互，下面将介绍其安装和配置过程。

✨ 主要特性

• 🚀 Unreal 实例管理
  • 通过多播自动发现 Unreal 节点，无需手动逐个添加，方便快捷。
  • 实时监控节点状态，让你随时了解节点的运行情况。
  • 通过兼容 LSP 客户端列出资源，便于资源的管理和查看。
• 💻 远程执行
  • 可在 Unreal Engine 环境中执行 Python 代码，拓展了功能的实现方式。
  • 支持 attended 和 unattended 两种执行模式，满足不同场景的需求。
  • 提供文件执行和语句评估模式，灵活处理不同类型的代码。
• 📊 日志记录与监控
  • 详细日志记录到文件（mcp_unreal.log），方便后续问题排查和分析。
  • 带不同 verbosity 级别的控制台日志，可根据需要调整日志的详细程度。
  • 节点连接状态健康监控，确保节点连接的稳定性。

📦 安装指南

# 克隆仓库
git clone https://github.com/your-org/mcp-unreal-server.git
cd mcp-unreal-server

# 安装依赖项
pip install -r requirements.txt

📚 详细文档

配置

网络设置

在 RemoteExecutionConfig 中配置多播参数：

# 默认多播设置（修改在 server.py 中）
config.multicast_group_endpoint = ("239.0.0.1", 6766)

日志记录

在 server.py 中调整日志级别：

# 调整日志级别
file_handler.setLevel(logging.DEBUG)  # 文件日志
console_handler.setLevel