基本能力
产品定位
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
文件,监控节点状态变化。
使用教程
使用依赖
```bash
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 部分)。
调试方式
```bash
启动服务器
python -m src.mcp_server_unreal.server
```
启动后,可以通过日志文件 mcp_unreal.log
和控制台输出来监控服务器状态和调试问题。