MCP Unreal Server
2025.04.12
3
HTMLUnreal Engine 交互远程执行开发工具开发效率
MCP Unreal Server 是一个用于通过远程 Python 执行与 Unreal Engine 实例交互的服务器实现。它提供了 Unreal 实例管理、远程执行以及日志和监控功能，适用于需要与 Unreal Engine 进行远程交互的开发场景。
View on GitHub
Overview
基本能力
产品定位
MCP Unreal Server 是一个用于与 Unreal Engine 实例进行远程交互的服务器，支持通过 Python 代码执行和管理 Unreal 节点。
核心功能
- Unreal 实例管理
- 通过多播自动发现 Unreal 节点
- 实时节点状态监控
-
通过 LSP 兼容客户端列出资源
-
远程执行
- 在 Unreal Engine 环境中执行 Python 代码
- 支持有监督和无监督执行模式
-
文件执行和语句评估模式
-
日志和监控
- 详细日志记录到文件 (
mcp_unreal.log) - 不同详细级别的控制台日志
- 节点连接健康监控
适用场景
- 需要远程管理多个 Unreal Engine 实例的开发环境
- 自动化测试和脚本执行
- 实时监控 Unreal 节点的状态和资源
工具列表
- Connect to Unreal Instance
- 用于连接到 Unreal 实例的工具，支持多播发现和连接。
- Execute Python Code
- 在 Unreal Engine 环境中执行 Python 代码的工具，支持多种执行模式。
常见问题解答
- No nodes discovered: 确保 Unreal 实例已安装 MCP 插件并正在运行。
- Execution timeout: 检查防火墙设置，确保允许多播流量。
- Connection drops: 查看
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
安装教程
- 克隆仓库并安装依赖（如上所示）。
- 配置网络设置和日志级别（参考 README 中的 Configuration 部分）。
调试方式
# 启动服务器
python -m src.mcp_server_unreal.server
启动后，可以通过日志文件 mcp_unreal.log 和控制台输出来监控服务器状态和调试问题。