UnrealMCP 插件

极早期开发版本 (VERY WIP)

我目前正在添加更多工具并清理代码库，计划允许在主插件之外进行更便捷的工具扩展。

这是一个处于极早期开发阶段的项目，还有很多内容需要完善！！

另外，我只使用 Windows 系统，因此不确定它在 Mac/Unix 平台下应如何配置。

概述

UnrealMCP 是一个非官方的 Unreal Engine 插件，旨在通过 AI 工具控制 Unreal Engine。它在 Unreal Engine 内部实现了机器控制协议 (MCP)，允许外部 AI 系统以编程方式与 Unreal 环境进行交互和操作。

我几天前才开始接触 MCP，所以还不够熟悉，目前仍在学习中，因此初期阶段可能会有一些粗糙的地方。该插件参考了 https://github.com/ahujasid/blender-mcp 进行实现，该参考项目依赖于 Claude for Desktop。它可能适用于其他模型，也可能不适用，如果你有相关测试，欢迎反馈给我！

⚠️ 免责声明

该插件允许 AI Agent 直接修改你的 Unreal Engine 项目。虽然它是一个强大的工具，但也伴随着风险：

AI Agent 可能会对你的项目进行意料之外的修改
文件可能被意外删除或修改
项目设置可能被更改
资产可能被覆盖

重要安全措施：

请务必在项目中使用版本控制（如 Git 或 Perforce）
定期备份你的项目
先在一个单独的项目中测试该插件
在提交更改之前，请仔细审查变更内容

使用本插件即代表你确认：

你对项目所做的任何更改负全部责任
插件作者不对 AI Agent 造成的任何损坏、数据丢失或问题负责
使用该插件的风险由你自行承担

功能特性

用于远程控制 Unreal Engine 的 TCP 服务器实现
用于 AI 工具集成的基于 JSON 的命令协议
集成编辑器 UI，便于访问 MCP 功能
全面的场景操作能力
用于客户端交互的 Python 配套脚本

开发路线图

这是截至 2025 年 3 月 14 日的开发计划。我不确定哪些功能是可以实现的，理论上都可以，但取决于集成的 LLM 在使用这些工具时的能力。

系统要求

Unreal Engine 5.5（我仅在此版本上进行了测试，可能适用于更早版本，但不提供官方支持）
为 Unreal Engine 配置好的 C++ 开发环境
用于客户端脚本的 Python 3.7+
用于运行命令的模型，在测试中我使用的是 Claude for Desktop: https://claude.ai/download

安装指南

将此仓库克隆到你的 Unreal 项目的 Plugins 目录中：
```
git clone https://github.com/kvick-games/UnrealMCP.git Plugins/UnrealMCP
```
项目路径应符合以下格式： ...\UNREAL_PROJECT\Plugins\UnrealMCP\
重新生成项目文件（右键点击你的 .uproject 文件，选择 "Generate Visual Studio project files"）
在你使用的 IDE 中构建项目，我使用的是 Rider，Visual Studio 也可以（目前正在筹备发布版）
打开项目并在 Edit > Plugins 中启用 UnrealMCP 插件
在 Unreal 中启用 Python 插件
运行 setup_unreal_mcp.bat（随着更多用户尝试，我可能需要对该文件进行一些修复）
目前我只在 Claude for Desktop 上进行了测试，请按照下方的说明继续配置

在 Claude for Desktop 中使用

你需要找到 Claude for Desktop 的安装目录。找到 claude_desktop_config.json 文件并添加一个条目，格式如下：

{
    "mcpServers": {
        "unreal": {
            "command": "C:\\UnrealMCP_Project\\Plugins\\UnrealMCP\\MCP\\run_unreal_mcp.bat",
            "args": []
        }
    }
}

在 COMMAND 字段中，输入你插件目录中 run_unreal_mcp.bat 脚本的路径。该脚本位于 ../plugin_root_directory/MCP/run_unreal_mcp.bat。

你可以参考此链接获取更多信息： https://modelcontextprotocol.io/quickstart/user

要找到 Claude for Desktop 的安装路径，可以在设置中点击 'Edit Config'。在我的 Windows PC 上，路径为： C:\Users\USERNAME\AppData\Roaming\Claude