Back to MCP directory
publicPublicdnsLocal runtime

radial-hks_MCP-Unreal-Server

一个用于通过远程Python执行与Unreal Engine实例交互的服务器实现,支持节点管理、远程代码执行和实时监控。

article

README

🚀 MCP虚幻服务器

MCP虚幻服务器是一个强大的工具,它能让你通过远程Python执行与Unreal Engine实例进行交互,有效提升开发效率,为开发者带来更便捷的开发体验。

🚀 快速开始

MCP虚幻服务器可帮助你通过远程Python执行与Unreal Engine实例交互。以下是使用前的安装和配置步骤。

✨ 主要特性

  • 🚀 虚幻实例管理
    • 借助多播功能,可自动发现虚幻节点,无需手动繁琐查找。
    • 能实时监控节点状态,让你随时掌握节点的运行情况。
    • 支持LSP(Language Server Protocol)客户端,可方便地列出资源。
  • 💻 远程执行
    • 可在Unreal Engine环境中直接执行Python代码,实现灵活的功能扩展。
    • 提供attended和unattended两种执行模式,满足不同场景的需求。
    • 支持文件执行和语句评估模式,使用方式多样。
  • 📊 日志与监控
    • 详细的日志会记录到文件(mcp_unreal.log)中,方便后续分析。
    • 控制台日志带有不同_verbose_级别,可根据需要查看。
    • 能对节点连接健康状态进行监控,及时发现并解决问题。

📦 安装指南

# 克隆仓库
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
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client