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许可证

Install Server

F

license - not found

C

quality

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

execute-pythonC

MCP Unreal Server