MCP Unreal Server

一个用于通过远程 Python 执行与 Unreal Engine 实例交互的服务器实现。

特性

• 🚀 Unreal 实例管理

  • 通过组播自动发现 Unreal 节点
  • 实时节点状态监控
  • 通过 LSP 兼容客户端进行资源列表

• 💻 远程执行

  • 在 Unreal Engine 环境中执行 Python 代码
  • 支持有人值守和无人值守执行模式
  • 文件执行和语句评估模式

• 📊 日志记录与监控

  • 详细的日志记录到文件 (mcp_unreal.log)
  • 具有不同详细程度的控制台日志记录
  • 节点连接健康状况监控

安装

# 克隆仓库
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(logging.INFO)  # 控制台日志记录

用法

启动服务器

python -m src.mcp_server_unreal.server

支持的工具

1. 连接到 Unreal 实例

{
  "host": "239.0.0.1",
  "port": 6766
}

2. 执行 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_STATEMENT	执行 Python 语句
MODE_EVAL_STATEMENT	评估 Python 表达式

故障排除

常见问题：

• 未发现节点：验证 Unreal 实例是否正在运行 MCP 插件
• 执行超时：检查防火墙设置是否允许组播流量
• 连接断开：监控 mcp_unreal.log 以了解节点状态变化

许可证

Apache-2.0 许可证