更新日期：2026年3月25日

---

Flop MCP

只需一个 URL 和一个 API 密钥。如果你的 AI 工具支持 MCP，它就能立即在你正在运行的 Unreal Editor 中进行检查、搜索和构建。兼容 Cursor、Claude Code、Windsurf、Cline、VS Code Copilot、OpenClaw 以及其他任何 MCP 客户端。

快速设置（远程 MCP）

将 Unreal Engine 工具接入你的 IDE 的最快方式是使用托管的 Flop MCP，地址为 flopperam.com/mcp。无需本地服务器，也不需要安装 Python——只需一个 URL 和一个 API 密钥即可。

1. 在 flopperam.com/account 获取 API 密钥。
2. 在你的项目中安装 Unreal 插件——详情请参见 flopperam.com/docs。前往“安装”选项卡查看具体步骤。
3. 将配置添加到你的 IDE：

Cursor — .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局级）：

{
  "mcpServers": {
    "flopperam-unreal": {
      "url": "https://agent.flopperam.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code — 在终端中运行：

claude mcp add -H "Authorization: Bearer YOUR_API_KEY" --transport http flopperam-unreal https://agent.flopperam.com/mcp

Cline / 本地 LLMs（Ollama、LM Studio 等）：

{
  "mcpServers": {
    "flopperam-unreal": {
      "type": "streamableHttp",
      "url": "https://agent.flopperam.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

完成以上步骤后，在你的 IDE 中确认服务器已连接，即可开始调用。

---

The Flop Agent — flopperam.com

Flop MCP 为你的 IDE 提供数据。而 The Flop Agent 则是一个完全自主的 AI，它直接运行在 Unreal Engine 内部——能够规划多步骤工作流、编写并执行代码、从错误中恢复，并不断迭代直至任务完成。

• 动态工作流——将复杂请求分解为多个步骤，并在出现问题时自动调整。
• Unreal 原生推理——优化的提示词设计、专用路由机制，以及对 UE API 和蓝图的深入理解。
• 完整的蓝图创建与编辑——可新建蓝图、添加变量/组件/事件/函数，更新图表逻辑，编译并验证。
• 世界构建——创建材质、放置 Actor、搭建建筑，并在过程中实时验证。
• 代码执行——直接在编辑器内执行命令——生成 Actor、编辑蓝图、构建关卡。
• 多模型协同——根据任务类型选择最佳模型（Opus 用于推理，Flash 用于查询）。
• Unreal 内嵌聊天——内置浏览器面板，无需切换窗口。
• 文本/图像转 3D——提供三种质量等级（良好、高质量、极高）。

支持 Unreal Engine 5.5、5.6 和 5.7。完整文档请访问 flopperam.com/docs。

---

面向 Unreal Engine 的最先进 MCP 服务器

通过自然语言控制 Unreal Engine 5.5 及更高版本——该 MCP 服务器使 AI 客户端能够构建令人惊叹的 3D 世界和建筑杰作。借助 AI 驱动的指令，你可以创建整个城镇、中世纪城堡、现代豪宅、复杂的迷宫以及各种精巧结构。

持续开发中：此 MCP 服务器正处于积极开发阶段，我们会定期发布更新和改进。加入我们的 Discord，及时获取最新动态！

实际演示

观看我们的综合教程，了解完整的设置与使用方法：

• 完整 MCP 教程及安装指南——涵盖安装、配置及高级用法的全程演示。

在我们的频道上查看更多 MCP 服务器的实际应用示例：

• GPT-5 vs Claude——观看 Claude 和 GPT-5 同时竞争建造场景：Claude 打造一座巨大堡垒，而 GPT-5 则建设一座 sprawling 城市。
• 高级大都市生成——AI 仅凭一条提示语便生成了一座拥有塔楼、街道、公园等设施，包含超过 4,000 个对象的完整大都市。
• 复杂迷宫与豪宅生成——Claude 生成了一个可游玩的迷宫，以及带有翼楼、塔楼和拱门的完整豪宅群。

特色功能

全面蓝图可视化脚本编程

通过 AI 完全编程蓝图，实现全面的节点创建、图表管理以及变量系统。

# 创建包含控制流、变量和函数的复杂蓝图逻辑
> “创建一个带有健康系统的蓝图，追踪伤害并触发死亡事件”
→ create_blueprint() + create_variable() + add_node() + connect_nodes()

# 支持 6 大类共 23 种以上的节点类型：
# 控制流：分支、比较、开关（字节/枚举/整数）、执行序列
# 数据：变量获取、变量设置、数组创建
# 类型转换：动态类型转换、类动态类型转换、字节转枚举
# 实用工具：打印、调用函数、选择、生成 Actor
# 专用节点：时间轴、获取数据表行、按类添加组件、自身、结点
# 动画：播放动画、停止动画、时间轴节点

高级蓝图特性：

• 函数管理：创建自定义函数，设置输入输出参数，重命名或删除。
• 变量系统：全面属性控制（公有/私有、复制、工具提示、范围、单位）。
• 节点属性：动态引脚管理、类型修改、语义化编辑。
• 图表分析：读取完整蓝图内容，分析执行流程，检查变量。
• 连接系统：自动类型校验下连接节点。

世界构建与建筑设计

# 构建拥有摩天大楼、飞行汽车和先进基础设施的未来感城市
> “建造一座拥有高耸摩天大楼的巨大未来城市”
→ create_town(town_size="massive", architectural_style="futuristic", building_density=0.95)

# 搭建带窗户、门和屋顶的复杂多房间住宅
> “创建一座维多利亚风格的豪宅群，包括东西两翼”
→ construct_house(house_style="mansion", width=1500, height=900)

智能迷宫

# 使用递归回溯法生成保证有解的迷宫
> “制作一个15x15、高墙的迷宫”
→ create_maze(rows=15, cols=15, wall_height=4, cell_size=250)

---

完整工具库

类别	工具	描述
蓝图可视化脚本	add_node, connect_nodes, delete_node, set_node_property, create_variable, set_blueprint_variable_properties, create_function, add_function_input, add_function_output, delete_function, rename_function	提供完整的蓝图编程功能，包含23多种节点类型、可完全控制属性的变量、自定义函数以及动态图管理
蓝图分析	read_blueprint_content, analyze_blueprint_graph, get_blueprint_variable_details, get_blueprint_function_details	对蓝图结构、事件图表、执行流程、变量和函数进行深度检查
世界构建	create_town, construct_house, construct_mansion, create_tower, create_arch, create_staircase	构建复杂的建筑结构和整个定居点
史诗级建筑	create_castle_fortress, create_suspension_bridge, create_aqueduct	巨大的工程奇迹和中世纪堡垒
关卡设计	create_maze, create_pyramid, create_wall	设计具有挑战性的游戏关卡和谜题
物理与材质	spawn_physics_blueprint_actor, set_physics_properties, get_available_materials, apply_material_to_actor, apply_material_to_blueprint, set_mesh_material_color	创建逼真的物理模拟和材质系统
蓝图系统	create_blueprint, compile_blueprint, add_component_to_blueprint, set_static_mesh_properties	可视化脚本编写和自定义Actor创建
Actor管理	get_actors_in_level, find_actors_by_name, delete_actor, set_actor_transform, get_actor_material_info	精确控制场景中的对象并进行检查

---

高速搭建

前提条件

• 虚幻引擎5.5及以上版本
• Python 3.12及以上版本
• MCP客户端（Claude Desktop、Cursor或Windsurf）

1. 搭建选项

选项A：使用预构建项目（推荐快速上手）

# 克隆仓库
git clone https://github.com/flopperam/unreal-engine-mcp.git
cd unreal-engine-mcp

# 打开预配置好的项目
# 双击 FlopperamUnrealMCP/FlopperamUnrealMCP.uproject
# 或通过虚幻引擎启动器打开

# 插件已安装并启用！

选项B：将插件添加到现有项目

# 将插件复制到您的项目
cp -r UnrealMCP/ YourProject/Plugins/

# 在虚幻编辑器中启用
编辑 → 插件 → 搜索“UnrealMCP” → 启用 → 重启编辑器

选项C：为所有项目安装

# 复制到引擎插件文件夹（对所有项目可用）
cp -r UnrealMCP/ "C:/Program Files/Epic Games/UE_5.5/Engine/Plugins/"

# 在任意项目中通过插件浏览器启用
编辑 → 插件 → 搜索“UnrealMCP” → 启用

Mac系统的额外步骤

如果您使用的是macOS，并且由于编译错误导致虚幻引擎无法打开项目，您需要先手动编译C++插件。具体步骤如下：

第一步：检查Xcode版本

xcodebuild -version
xcrun --show-sdk-version

记录您的Xcode版本号（例如，“26.0.1”、“16.0”、“15.2”等）。如果您的版本高于16.0，则需要修补虚幻引擎的SDK配置。

第二步：修补虚幻引擎SDK配置

编辑您虚幻引擎安装目录下的文件（将“UE_5.X”替换为您使用的版本）：

# 编辑路径：
/Users/Shared/Epic Games/UE_5.X/Engine/Config/Apple/Apple_SDK.json

更新以下值：

更改1： 更新MaxVersion以支持您的Xcode版本

{
  "MaxVersion": "YOUR_XCODE_VERSION.9.0",  // 例如，如果您使用的是Xcode 26.x，则填写“26.9.0”
}

将YOUR_XCODE_VERSION替换为您在第一步中记录的Xcode主版本号。

更改2： 为您的Xcode版本添加LLVM版本映射（添加到AppleVersionToLLVMVersions数组中）

{
  "AppleVersionToLLVMVersions": [
    "14.0.0-14.0.0",
    "14.0.3-15.0.0",
    "15.0.0-16.0.0",
    "16.0.0-17.0.6",
    "16.3.0-19.1.4",
    "YOUR_XCODE_VERSION.0.0-19.1.4"  // 例如，对于Xcode 26.x，填写“26.0.0-19.1.4”
  ]
}

同样，将YOUR_XCODE_VERSION替换为您在第一步中记录的Xcode主版本号。

第三步：编译插件

运行虚幻构建工具来编译项目：

"/Users/Shared/Epic Games/UE_5.X/Engine/Build/BatchFiles/Mac/Build.sh" \
  UnrealEditor Mac Development \
  -Project="/path/to/unreal-engine-mcp/FlopperamUnrealMCP/FlopperamUnrealMCP.uproject" \
  -WaitMutex

请替换：

• UE_5.X为您使用的虚幻引擎版本（例如，“UE_5.5”）
• /path/to/unreal-engine-mcp/为您克隆仓库的实际路径

第四步：打开项目

编译成功后，您就可以在虚幻引擎中打开FlopperamUnrealMCP.uproject了。

2. 启动MCP服务器

cd Python
uv run unreal_mcp_server_advanced.py

3. 配置您的AI客户端

将以下内容添加到您的MCP配置中：

Cursor：.cursor/mcp.json Claude Desktop：~/.config/claude-desktop/mcp.json Windsurf：~/.config/windsurf/mcp.json

{
  "mcpServers": {
    "unrealMCP": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/unreal-engine-mcp/Python",
        "run",
        "unreal_mcp_server_advanced.py"
      ]
    }
  }
}

请注意，在Mac以及有时在Windows上，您可能需要将上述mcp.json文件中command字段的值“uv”替换为uv可执行文件的完整绝对路径。要获取该路径，请运行以下命令之一：

• Mac：which uv
• Windows：where uv

设置遇到问题？ 请查看我们的调试与故障排除指南，以解决常见的MCP安装错误和配置问题。

想用AI编程蓝图吗？ 请参阅我们的蓝图图形编程指南，学习如何以编程方式创建节点、连接和变量。

4. 开始建造！

> “创建一座带有塔楼和城墙的中世纪城堡”
> “生成一个带有喷泉和建筑的城镇广场”
> “制作一个玩家需要解开的挑战性迷宫”

---

架构

graph TB
    A[AI客户端<br/>Cursor/Claude/Windsurf] -->|MCP协议| B[Python服务器<br/>unreal_mcp_server_advanced.py]
    B -->|TCP套接字| C[C++插件<br/>UnrealMCP]
    C -->|原生API| D[虚幻引擎5.5+<br/>编辑器与运行时]
    
    B --> E[高级工具]
    E --> F[世界构建]
    E --> G[物理模拟]  
    E --> H[蓝图系统]
    
    C --> I[Actor管理]
    C --> J[组件系统]
    C --> K[材质系统]

性能: 原生C++插件确保实时控制的极低延迟
可靠性: 强健的TCP通信，支持自动重连
灵活性: 完全访问虚幻引擎的Actor、组件和蓝图系统

---

社区与支持

加入我们的社区，一起打造精彩的世界吧！

与我们联系

• YouTube: youtube.com/@flopperam - 教程、作品展示及开发更新
• Discord: discord.gg/8yr1RBv - 获取帮助、分享创作并讨论插件
• Twitter/X: twitter.com/Flopperam - 最新消息与快速更新
• TikTok: tiktok.com/@flopperam - 快速技巧与精彩作品

获取帮助与分享

• 设置问题？ 请先查看我们的调试与故障排除指南
• 有疑问？ 欢迎在Discord服务器中提问，我们将提供实时支持
• Bug报告？ 请在GitHub上提交包含复现步骤的问题
• 功能建议？ 欢迎在社区频道中参与讨论

---

许可证

MIT许可证 - 自由地构建精彩内容。

unreal-engine-mcp 快速上手指南

unreal-engine-mcp 是一个强大的 MCP（Model Context Protocol）服务器，允许 AI 助手（如 Cursor、Claude Code、Windsurf 等）通过自然语言直接控制 Unreal Engine 5.5+ 编辑器。它可以自动创建蓝图、构建建筑、生成迷宫以及管理场景资产。

环境准备

在开始之前，请确保满足以下系统要求：

• Unreal Engine: 版本 5.5 或更高（支持 5.5, 5.6, 5.7）。
• Python: 版本 3.12 或更高。
• MCP 客户端: 已安装支持的 IDE 或工具（推荐 Cursor, Claude Desktop, Windsurf, Cline 等）。
• 操作系统: Windows 或 macOS。
  • macOS 用户注意: 若遇到编译错误，需确保 Xcode 版本与 UE SDK 配置兼容（详见原文档 Mac 部分）。

安装步骤

你可以选择远程托管模式（最快，无需本地配置 Python 服务）或本地源码模式。

方案 A：远程托管模式（推荐，最快上手）

此方案无需本地运行 Python 服务器，只需一个 URL 和 API Key 即可连接。

1. 获取 API Key 访问 flopperam.com/account 注册并获取你的 API Key。

2. 安装 Unreal 插件

   • 下载插件文件（参考官方文档 flopperam.com/docs）。
   • 将插件文件夹复制到你的项目目录：

     cp -r UnrealMCP/ YourProject/Plugins/
     

   • 打开 Unreal Editor，进入 Edit → Plugins，搜索 "UnrealMCP" 并启用，然后重启编辑器。

3. 配置 MCP 客户端 根据你的 IDE 添加以下配置（将 YOUR_API_KEY 替换为你的实际密钥）：

   Cursor (编辑 .cursor/mcp.json 或 ~/.cursor/mcp.json):

   {
     "mcpServers": {
       "flopperam-unreal": {
         "url": "https://agent.flopperam.com/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_API_KEY"
         }
       }
     }
   }
   

   Claude Code (在终端运行):

   claude mcp add -H "Authorization: Bearer YOUR_API_KEY" --transport http flopperam-unreal https://agent.flopperam.com/mcp
   

   Cline / 本地 LLM 客户端:

   {
     "mcpServers": {
       "flopperam-unreal": {
         "type": "streamableHttp",
         "url": "https://agent.flopperam.com/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_API_KEY"
         }
       }
     }
   }
   

方案 B：本地源码模式（适合开发者调试）

1. 克隆仓库

   git clone https://github.com/flopperam/unreal-engine-mcp.git
   cd unreal-engine-mcp
   

2. 设置项目

   • 双击打开 FlopperamUnrealMCP/FlopperamUnrealMCP.uproject。
   • 或者将 UnrealMCP 文件夹复制到你现有项目的 Plugins 目录下并在编辑器中启用。

3. 启动 MCP 服务器 确保 Unreal Editor 正在运行该项目，然后在终端启动 Python MCP 服务（具体启动命令需参考仓库内的 requirements.txt 安装依赖后运行主脚本，通常涉及 python -m uvicorn 或类似入口，此处建议使用方案 A 以简化流程）。

基本使用

配置完成后，确保 Unreal Editor 处于运行状态且插件已加载。在你的 AI 编辑器（如 Cursor 聊天窗口）中，确认 MCP 服务器状态为 "Connected"。

你可以直接使用自然语言下达指令，AI 将自动调用工具在引擎中执行操作。

使用示例

示例 1：创建复杂的蓝图逻辑

"Create a Blueprint with a health system that tracks damage and triggers a death event"

效果：AI 会自动创建一个蓝图，添加生命值变量，编写伤害计算逻辑，并连接死亡事件节点。

示例 2：构建大型建筑

"Build a massive futuristic city with towering skyscrapers"

效果：调用 create_town 工具，生成具有高密度未来风格建筑的城镇。

示例 3：生成游戏关卡

"Make a 15x15 maze with high walls"

效果：调用 create_maze 工具，使用递归回溯算法生成一个可解的迷宫。

示例 4：物理与材质操作

"Spawn a physics actor and apply a red metal material to it"

效果：生成带有物理属性的 Actor，并自动查找并应用红色金属材质。

---

提示：更多高级功能（如自主代理工作流、多模型路由）请访问 flopperam.com 查看完整文档。