使用说明

项目简介

Dreamatron Agent 是一个为虚幻引擎设计的AI 协副驾驶插件，它集成了 MCP 服务器，旨在通过 AI 工具增强虚幻引擎的控制能力。该插件允许外部 AI 智能体以标准化的方式与虚幻引擎交互，实现远程控制和自动化工作流程，特别适用于游戏开发和虚拟内容创作领域。

主要功能点

MCP 服务器实现: 实现了 Model Context Protocol 服务器，允许 Claude for Desktop 等 MCP 客户端连接并控制虚幻引擎。
远程控制: 通过 TCP 协议提供远程控制虚幻引擎的能力。
场景操作: 支持全面的场景操作，包括对象创建、修改、删除和场景信息查询。
工具集成: 集成了多种工具，如Python脚本执行、材质编辑、蓝图操作和文件系统访问等，可通过 AI 智能体调用。
编辑器 UI 集成: 提供编辑器内用户界面，方便用户直接访问和控制 MCP 功能。
客户端 Python 脚本: 提供了 Python 客户端库和示例脚本，方便开发者构建自定义 MCP 客户端。

安装步骤

克隆仓库: 将 DreamatronAgent 仓库克隆到你的虚幻引擎项目的 'Plugins' 目录下。

git clone https://github.com/dreamatron/DreamatronAgent.git Plugins/DreamatronAgent

生成项目文件: 右键点击你的 '.uproject' 文件，选择 "Generate Visual Studio project files" 以重新生成项目文件。
编译项目: 在你使用的 IDE (如 Rider, Visual Studio) 中编译项目。
启用插件: 打开你的虚幻引擎项目，在 "Edit > Plugins > DreamatronAgent" 中启用插件。
启用 Python 插件: 确保在虚幻引擎中启用了 Python 插件。
运行 Setup 脚本: 运行 'setup_unreal_mcp.bat' 脚本，完成 MCP 环境的设置（可能需要根据实际情况进行调整）。

服务器配置

为了让 MCP 客户端（例如 Claude for Desktop）连接到 Dreamatron Agent MCP 服务器，您需要配置客户端的 MCP 服务器设置。以下是 Claude for Desktop 的配置示例，您需要将 'command' 字段中的路径替换为您实际的插件目录路径。

{
    "mcpServers": {
        "unreal": {
            "command": "C:\\Unreal_Project\\Plugins\\DreamatronAgent\\MCP\\run_unreal_mcp.bat", // **[请替换为你的插件目录中 run_unreal_mcp.bat 脚本的完整路径]**
            "args": [] // **[可选参数，本插件无需配置]**
        }
    }
}

基本使用方法

启动 Unreal Engine 编辑器: 确保你的虚幻引擎项目已打开，并且 Dreamatron Agent 插件已启用。
启动 MCP 服务器: 在虚幻引擎编辑器工具栏中，找到 MCP 控制按钮，点击启动 TCP 服务器。
配置 MCP 客户端: 根据 MCP 客户端（如 Claude for Desktop）的文档，配置 MCP 服务器连接信息，指定启动命令为 'run_unreal_mcp.bat' 脚本的路径。
连接客户端: 在 MCP 客户端中连接到 Dreamatron Agent MCP 服务器。
使用 AI 智能体: 通过 MCP 客户端向 AI 智能体发送指令，控制虚幻引擎进行场景操作、资源管理或工具调用。
客户端 Python 脚本: 您可以使用 'MCP' 目录中提供的 Python 脚本 'unreal_mcp_client.py' 构建自定义客户端，通过 Python 代码与 Unreal Engine 的 MCP 服务器进行交互。

注意

该插件尚处于早期开发阶段，请勿在重要的项目中使用。
插件目前仅支持 Windows 操作系统。
使用插件前务必备份你的虚幻引擎项目，并使用版本控制系统。

关键词

使用说明

信息