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 許可證。