Unreal MCP

🚀 unreal - mcp

unreal - mcp 是一款适用于虚幻引擎（Unreal Engine）的 MCP 服务器，它借助虚幻引擎的 Python 远程执行功能，为开发者提供便捷的操作体验。

Twitter · Discord

🚀 快速开始

unreal - mcp 服务器利用虚幻引擎内置的 Python 远程执行协议，无需安装新的 UE 插件。并且由于无需编写任何 C++ 代码，添加新工具或功能的开发速度更快。它还能支持完整的 虚幻引擎 Python API。

✨ 主要特性

⚡ 与其他服务器的差异

• 此服务器使用内置的 Python 远程执行协议，无需安装新的 UE 插件。
• 由于无需任何 C++ 代码，添加新工具/功能的开发速度快得多。
• 可以支持完整的 虚幻引擎 Python API

⚠️ 重要提示

• 这不是官方的虚幻引擎项目。
• 您的 AI 代理或工具将可以完全访问您的编辑器。
• 在批准客户端建议的任何更改之前，请先进行审核。

📦 安装指南

📋 安装要求

• 🔧 虚幻引擎 5.4+（已验证，早期版本可能也适用）
• 🟢 带有 npx 的 Node.js
• 🤖 MCP 客户端（Claude、Cursor 等）

安装步骤

1. 编辑器设置：
   • 打开您的虚幻引擎项目。
   • 转到 编辑 -> 插件。
   • 搜索“Python 编辑器脚本插件”并启用它。
   • 如果提示，请重启编辑器。
   • 转到 编辑 -> 项目设置。
   • 搜索“Python”并启用“启用远程执行”选项。

2. 客户端设置：
   • 编辑您的 Claude（或 Cursor）配置。

{
  "mcpServers": {
    "unreal": {
      "command": "npx",
      "args": [
        "-y",
        "@runreal/unreal-mcp"
      ]
    }
  }
}

🔧 故障排除

如果您遇到类似于 MCP Unreal: Unexpected token 'C', Connection... 的错误，这意味着 mcp - 服务器无法连接到虚幻编辑器。

• 确保已启用 Python 编辑器脚本插件，并在项目设置中勾选了远程执行选项。
• 也可以尝试将绑定地址从 127.0.0.1 更改为 0.0.0.0，但请注意，这将允许来自本地网络的连接。
• 完全重启您的虚幻编辑器。
• 完全关闭/打开您的客户端（Claude、Cursor 等），以确保它重新连接到 MCP 服务器（在 Windows 上为 文件 -> 退出）。
• 检查正在运行的进程，并终止任何僵尸 unreal - mcp Node.js 进程。

🛠️ 可用工具

🤝 贡献代码

欢迎您随时提出问题或提交拉取请求。我们尤其欢迎添加新工具/命令的贡献。

📄 许可证

本项目采用 MIT 许可证。