MCP 虚幻服务器
通过远程 Python 执行与虚幻引擎实例交互的服务器实现。
特征
🚀虚幻实例管理
通过多播自动发现虚幻节点
实时节点状态监控
通过 LSP 兼容客户端列出资源
💻远程执行
在虚幻引擎环境中执行 Python 代码
支持有人值守和无人值守的执行模式
文件执行和语句评估模式
📊日志记录和监控
详细记录到文件（
mcp_unreal.log）具有不同详细程度的控制台日志记录
节点连接健康监控
Related MCP server: Unity MCP Integration
安装
# Clone repository
git clone https://github.com/your-org/mcp-unreal-server.git
cd mcp-unreal-server
# Install dependencies
pip install -r requirements.txt
配置
网络设置
在RemoteExecutionConfig中配置多播参数：
# Default multicast settings (modify in server.py)
config.multicast_group_endpoint = ("239.0.0.1", 6766)
日志记录
修改server.py中的日志配置：
# Adjust log levels
file_handler.setLevel(logging.DEBUG) # File logging
console_handler.setLevel(logging.INFO) # Console logging
用法
启动服务器
python -m src.mcp_server_unreal.server
支持的工具
连接到虚幻实例
{
"host": "239.0.0.1",
"port": 6766
}
执行 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"
)
执行模式
模式 | 描述 |
模式执行文件 | 执行 Python 文件 |
模式执行语句 | 执行 Python 语句 |
模式评估语句 | 计算 Python 表达式 |
故障排除
常见问题：
未发现节点：验证虚幻实例是否正在使用 MCP 插件运行
执行超时：检查防火墙设置中的多播流量
连接断开：监视
mcp_unreal.log以了解节点状态变化
执照
Apache-2.0许可证