[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-flopperam--unreal-engine-mcp":3,"tool-flopperam--unreal-engine-mcp":62},[4,18,26,36,46,54],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",159636,2,"2026-04-17T23:33:34",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":42,"last_commit_at":43,"category_tags":44,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,45],"插件",{"id":47,"name":48,"github_repo":49,"description_zh":50,"stars":51,"difficulty_score":32,"last_commit_at":52,"category_tags":53,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":32,"last_commit_at":60,"category_tags":61,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[45,13,15,14],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":77,"owner_location":77,"owner_email":77,"owner_twitter":73,"owner_website":78,"owner_url":79,"languages":80,"stars":97,"forks":98,"last_commit_at":99,"license":77,"difficulty_score":32,"env_os":100,"env_gpu":101,"env_ram":102,"env_deps":103,"category_tags":109,"github_topics":77,"view_count":32,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":111,"updated_at":112,"faqs":113,"releases":114},9003,"flopperam\u002Funreal-engine-mcp","unreal-engine-mcp","Control Unreal Engine 5.5+ through AI with natural language. Build incredible 3D worlds and architectural masterpieces using MCP. Create entire towns, medieval castles, modern mansions, challenging mazes, and complex structures with AI-powered commands.","unreal-engine-mcp 是一款专为虚幻引擎 5.5 及以上版本设计的 AI 协作工具，旨在通过自然语言指令直接控制编辑器，帮助用户构建复杂的 3D 世界与建筑杰作。它有效解决了传统 3D 开发中手动操作繁琐、蓝图编写门槛高以及重复性劳动耗时等痛点，让用户只需输入文字描述，即可自动生成城镇、城堡、迷宫等复杂结构。\n\n该工具特别适合游戏开发者、技术美术、建筑可视化设计师以及希望快速原型验证的创作者使用。其核心亮点在于集成了强大的\"Flop Agent\"自主智能体，不仅能理解用户意图，还能独立规划多步骤工作流：从动态创建和编辑蓝图逻辑（如添加变量、事件和函数），到自动放置演员、生成材质乃至执行代码编译，全程无需切换窗口。此外，它支持多种主流 AI 编程助手（如 Cursor、Claude Code 等）通过标准 MCP 协议无缝接入，既提供便捷的远程云服务模式，也具备根据任务难度自动路由不同 AI 模型的智能调度能力，让 3D 内容创作变得更加高效直观。","## Update 03\u002F25\u002F2026\n---\n## Flop MCP\n\nOne URL, one API key. If your AI tool supports MCP, it can inspect, search, and build inside your running Unreal Editor right now. Works with **Cursor, Claude Code, Windsurf, Cline, VS Code Copilot, OpenClaw**, and any other MCP client.\n\n### Quick Setup (Remote MCP)\n\nThe fastest way to get Unreal Engine tools in your IDE is the hosted **Flop MCP** at [flopperam.com\u002Fmcp](https:\u002F\u002Fflopperam.com\u002Fmcp). No local server, no Python install — just a URL and an API key.\n\n1. **Get an API key** at [flopperam.com\u002Faccount](https:\u002F\u002Fflopperam.com\u002Faccount)\n2. **Install the Unreal plugin in your project** — see [flopperam.com\u002Fdocs](https:\u002F\u002Fflopperam.com\u002Fdocs). Go to the Installation tab for instructions.\n3. **Add the config to your IDE:**\n\n**Cursor** — `.cursor\u002Fmcp.json` (project) or `~\u002F.cursor\u002Fmcp.json` (global):\n```json\n{\n  \"mcpServers\": {\n    \"flopperam-unreal\": {\n      \"url\": \"https:\u002F\u002Fagent.flopperam.com\u002Fmcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n**Claude Code** — run in your terminal:\n```bash\nclaude mcp add -H \"Authorization: Bearer YOUR_API_KEY\" --transport http flopperam-unreal https:\u002F\u002Fagent.flopperam.com\u002Fmcp\n```\n\n**Cline \u002F Local LLMs** (Ollama, LM Studio, etc.):\n```json\n{\n  \"mcpServers\": {\n    \"flopperam-unreal\": {\n      \"type\": \"streamableHttp\",\n      \"url\": \"https:\u002F\u002Fagent.flopperam.com\u002Fmcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\nThat's it — verify the server shows as connected in your IDE and start prompting.\n\n---\n\n## The Flop Agent — [flopperam.com](https:\u002F\u002Fflopperam.com\u002F)\n\nThe Flop MCP gives your IDE data. **The Flop Agent** is a fully autonomous AI that lives inside Unreal Engine — it plans multi-step workflows, writes and executes code, recovers from errors, and iterates until the job is done.\n\n- **Dynamic workflows** — decomposes complex requests into steps and adapts when something goes wrong\n- **Unreal-native reasoning** — tuned prompts, specialized routing, deep knowledge of UE APIs and Blueprints\n- **Full Blueprint creation and editing** — create new Blueprints, add variables\u002Fcomponents\u002Fevents\u002Ffunctions, update graph logic, compile and validate\n- **World building** — creates materials, places actors, builds structures, and verifies as it goes\n- **Code execution** — executes commands directly inside the editor — spawning actors, editing Blueprints, building levels\n- **Multiple AI models** — routes to the best model per task (Opus for reasoning, Flash for lookups)\n- **Chat inside Unreal** — embedded browser panel, no window switching\n- **Text\u002Fimage to 3D** — three quality tiers (Good, High Quality, Very High Quality)\n\nSupports Unreal Engine 5.5, 5.6, and 5.7. Full docs at [flopperam.com\u002Fdocs](https:\u002F\u002Fflopperam.com\u002Fdocs).\n\n\u003Cimg width=\"800\" alt=\"Flop AI creating a health system in BP_MyPlayer2 from a natural language prompt\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fflopperam_unreal-engine-mcp_readme_d77732d8f27e.png\" \u002F>\n\n\u003Cimg width=\"800\" alt=\"Flop AI building a full combat system in BP_Combat99 with health, armor, stamina, combo, and more\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fflopperam_unreal-engine-mcp_readme_eaad40cb8ca1.png\" \u002F>\n\n---\n\n# The Most Advanced MCP Server for Unreal Engine\n\n**Control Unreal Engine 5.5+ through AI with natural language** — This MCP server enables AI clients to build incredible 3D worlds and architectural masterpieces. Create entire towns, medieval castles, modern mansions, challenging mazes, and complex structures with AI-powered commands.\n\n[![Unreal Engine](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FUnreal%20Engine-5.5%2B-orange.svg)](https:\u002F\u002Fwww.unrealengine.com\u002F)\n[![YouTube](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FYouTube-@flopperam-red.svg?logo=youtube)](https:\u002F\u002Fyoutube.com\u002F@flopperam)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join%20Server-5865F2.svg?logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002F3KNkke3rnH)\n[![Twitter](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FX-@Flopperam-1DA1F2.svg?logo=x&logoColor=white)](https:\u002F\u002Ftwitter.com\u002FFlopperam)\n[![TikTok](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FTikTok-@flopperam-000000.svg?logo=tiktok&logoColor=white)](https:\u002F\u002Ftiktok.com\u002F@flopperam)\n\n> **Active Development**: This MCP server is under active development with regular updates and improvements. Join our [Discord](https:\u002F\u002Fdiscord.gg\u002F3KNkke3rnH) to stay updated on the latest releases!\n\n## See It In Action\nWatch our comprehensive tutorial for complete setup and usage:\n- **[Complete MCP Tutorial & Installation Guide](https:\u002F\u002Fyoutu.be\u002Fct5dNJC-Hx4)** - Full walkthrough of installation, setup, and advanced usage\n\nCheck out these examples of the MCP server in action on our channel:\n- **[GPT-5 vs Claude](https:\u002F\u002Fyoutube.com\u002Fshorts\u002FxgoJ4d3d4-4)** - Watch Claude and GPT-5 go head-to-head building simultaneously - Claude creates a massive fortress while GPT-5 builds a sprawling city\n- **[Advanced Metropolis Generation](https:\u002F\u002Fyoutube.com\u002Fshorts\u002F6WkxCQXbCWk)** - Watch AI generate a full-blown metropolis with towers, streets, parks, and over 4,000 objects from a single prompt\n- **[Advanced Maze & Mansion Generation](https:\u002F\u002Fyoutube.com\u002Fshorts\u002FArExYGpIZwI)** - Watch Claude generate a playable maze and complete mansion complex with wings, towers, and arches\n\n## Featured Capabilities\n\n### Complete Blueprint Visual Scripting\n\n**Program Blueprints entirely through AI** with comprehensive node creation, graph management, and variable systems.\n\n```bash\n# Create complex Blueprint logic with control flow, variables, and functions\n> \"Create a Blueprint with a health system that tracks damage and triggers a death event\"\n→ create_blueprint() + create_variable() + add_node() + connect_nodes()\n\n# Support for 23+ node types across 6 categories:\n# Control Flow: Branch, Comparison, Switch (Byte\u002FEnum\u002FInteger), ExecutionSequence\n# Data: VariableGet, VariableSet, MakeArray\n# Casting: DynamicCast, ClassDynamicCast, CastByteToEnum\n# Utility: Print, CallFunction, Select, SpawnActor\n# Specialized: Timeline, GetDataTableRow, AddComponentByClass, Self, Knot\n# Animation: PlayAnimation, StopAnimation, Timeline nodes\n```\n\n**Advanced Blueprint Features:**\n- **Function Management**: Create custom functions with inputs\u002Foutputs, rename, and delete\n- **Variable System**: Full property control (public\u002Fprivate, replication, tooltips, ranges, units)\n- **Node Properties**: Dynamic pin management, type modification, semantic editing\n- **Graph Analysis**: Read complete Blueprint content, analyze execution flow, inspect variables\n- **Connection System**: Wire nodes together with automatic type validation\n\n### World Building & Architecture  \n```bash\n# Create massive futuristic cities with skyscrapers, flying cars, and advanced infrastructure\n> \"Build a massive futuristic city with towering skyscrapers\"\n→ create_town(town_size=\"massive\", architectural_style=\"futuristic\", building_density=0.95)\n\n# Build complex multi-room houses with windows, doors, and roofs\n> \"Create a Victorian mansion complex with east and west wing houses.\"\n→ construct_house(house_style=\"mansion\", width=1500, height=900)\n```\n\n### Intelligent Mazes\n```bash\n# Generate solvable mazes with guaranteed paths using recursive backtracking\n> \"Make a 15x15 maze with high walls\"\n→ create_maze(rows=15, cols=15, wall_height=4, cell_size=250)\n```\n\n---\n\n## Complete Tool Arsenal\n\n| **Category** | **Tools** | **Description** |\n|--------------|-----------|-----------------|\n| **Blueprint Visual Scripting** | `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` | Complete Blueprint programming with 23+ node types, variables with full property control, custom functions, and dynamic graph management |\n| **Blueprint Analysis** | `read_blueprint_content`, `analyze_blueprint_graph`, `get_blueprint_variable_details`, `get_blueprint_function_details` | Deep inspection of Blueprint structure, event graphs, execution flow, variables, and functions |\n| **World Building** | `create_town`, `construct_house`, `construct_mansion`, `create_tower`, `create_arch`, `create_staircase` | Build complex architectural structures and entire settlements |\n| **Epic Structures** | `create_castle_fortress`, `create_suspension_bridge`, `create_aqueduct` | Massive engineering marvels and medieval fortresses |\n| **Level Design** | `create_maze`, `create_pyramid`, `create_wall` | Design challenging game levels and puzzles |\n| **Physics & Materials** | `spawn_physics_blueprint_actor`, `set_physics_properties`, `get_available_materials`, `apply_material_to_actor`, `apply_material_to_blueprint`, `set_mesh_material_color` | Create realistic physics simulations and material systems |\n| **Blueprint System** | `create_blueprint`, `compile_blueprint`, `add_component_to_blueprint`, `set_static_mesh_properties` | Visual scripting and custom actor creation |\n| **Actor Management** | `get_actors_in_level`, `find_actors_by_name`, `delete_actor`, `set_actor_transform`, `get_actor_material_info` | Precise control over scene objects and inspection |\n\n---\n\n## Lightning-Fast Setup\n\n### Prerequisites\n- **Unreal Engine 5.5+** \n- **Python 3.12+**\n- **MCP Client** (Claude Desktop, Cursor, or Windsurf)\n\n### 1. Setup Options\n\n**Option A: Use the Pre-Built Project (Recommended for Quick Start)**\n```bash\n# Clone the repository\ngit clone https:\u002F\u002Fgithub.com\u002Fflopperam\u002Funreal-engine-mcp.git\ncd unreal-engine-mcp\n\n# Open the pre-configured project\n# Double-click FlopperamUnrealMCP\u002FFlopperamUnrealMCP.uproject\n# or open it through Unreal Engine launcher\n\n# The plugin is already installed and enabled!\n```\n\n**Option B: Add Plugin to Your Existing Project**\n```bash\n# Copy the plugin to your project\ncp -r UnrealMCP\u002F YourProject\u002FPlugins\u002F\n\n# Enable in Unreal Editor\nEdit → Plugins → Search \"UnrealMCP\" → Enable → Restart Editor\n```\n\n**Option C: Install for All Projects**\n```bash\n# Copy to Engine plugins folder (available to all projects)\ncp -r UnrealMCP\u002F \"C:\u002FProgram Files\u002FEpic Games\u002FUE_5.5\u002FEngine\u002FPlugins\u002F\"\n\n# Enable in any project through the Plugin Browser\nEdit → Plugins → Search \"UnrealMCP\" → Enable\n```\n\n#### Extra steps for Mac\nIf you're on macOS and Unreal Engine fails to open the project due to compilation errors, you'll need to manually compile the C++ plugin first. To do so, follow these steps:\n\n##### Step 1: Check Your Xcode Version\n\n```bash\nxcodebuild -version\nxcrun --show-sdk-version\n```\n\nNote your Xcode version number (e.g., `26.0.1`, `16.0`, `15.2`, etc.). If your version is newer than 16.0, you'll need to patch the Unreal Engine SDK configuration.\n\n##### Step 2: Patch Unreal Engine SDK Configuration\n\nEdit the file at your Unreal Engine installation (replace `UE_5.X` with your version):\n\n```bash\n# Path to edit:\n\u002FUsers\u002FShared\u002FEpic Games\u002FUE_5.X\u002FEngine\u002FConfig\u002FApple\u002FApple_SDK.json\n```\n\nUpdate the following values:\n\n**Change 1:** Update `MaxVersion` to support your Xcode version\n```json\n{\n  \"MaxVersion\": \"YOUR_XCODE_VERSION.9.0\",  \u002F\u002F e.g., \"26.9.0\" if you have Xcode 26.x\n}\n```\nReplace `YOUR_XCODE_VERSION` with your major Xcode version from Step 1.\n\n**Change 2:** Add LLVM version mapping for your Xcode version (add to the `AppleVersionToLLVMVersions` array)\n```json\n{\n  \"AppleVersionToLLVMVersions\": [\n    \"14.0.0-14.0.0\",\n    \"14.0.3-15.0.0\",\n    \"15.0.0-16.0.0\",\n    \"16.0.0-17.0.6\",\n    \"16.3.0-19.1.4\",\n    \"YOUR_XCODE_VERSION.0.0-19.1.4\"  \u002F\u002F e.g., \"26.0.0-19.1.4\" for Xcode 26.x\n  ]\n}\n```\nReplace `YOUR_XCODE_VERSION` with your major Xcode version from Step 1.\n\n##### Step 3: Compile the Plugin\n\nRun the Unreal Build Tool to compile the project:\n\n```bash\n\"\u002FUsers\u002FShared\u002FEpic Games\u002FUE_5.X\u002FEngine\u002FBuild\u002FBatchFiles\u002FMac\u002FBuild.sh\" \\\n  UnrealEditor Mac Development \\\n  -Project=\"\u002Fpath\u002Fto\u002Funreal-engine-mcp\u002FFlopperamUnrealMCP\u002FFlopperamUnrealMCP.uproject\" \\\n  -WaitMutex\n```\n\nReplace:\n- `UE_5.X` with your Unreal Engine version (e.g., `UE_5.5`)\n- `\u002Fpath\u002Fto\u002Funreal-engine-mcp\u002F` with the actual path to your cloned repository\n\n##### Step 4: Open the Project\n\nOnce compilation succeeds, you can open `FlopperamUnrealMCP.uproject` in Unreal Engine.\n\n### 2. Launch the MCP Server\n\n```bash\ncd Python\nuv run unreal_mcp_server_advanced.py\n```\n\n### 3. Configure Your AI Client\n\nAdd this to your MCP configuration:\n\n**Cursor**: `.cursor\u002Fmcp.json`\n**Claude Desktop**: `~\u002F.config\u002Fclaude-desktop\u002Fmcp.json`\n**Windsurf**: `~\u002F.config\u002Fwindsurf\u002Fmcp.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"unrealMCP\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"\u002Fpath\u002Fto\u002Funreal-engine-mcp\u002FPython\",\n        \"run\",\n        \"unreal_mcp_server_advanced.py\"\n      ]\n    }\n  }\n}\n```\n\nNote that on Mac, and sometimes on Windows, you may have to replace the \"uv\" string passed as the value to \"command\" in the above `mcp.json` file with the exact absolute path to the uv executable. To get that path, run one of these commands:\n- Mac: `which uv`\n- Windows: `where uv`\n\n> **Having issues with setup?** Check our [Debugging & Troubleshooting Guide](DEBUGGING.md) for solutions to common problems like MCP installation errors and configuration issues.\n>\n> **Want to program Blueprints with AI?** Check our [Blueprint Graph Programming Guide](Guides\u002Fblueprint-graph-guide.md) to learn how to create nodes, connections, and variables programmatically.\n\n### 4. Start Building!\n\n```bash\n> \"Create a medieval castle with towers and walls\"\n> \"Generate a town square with fountain and buildings\"\n> \"Make a challenging maze for players to solve\"\n```\n\n---\n\n## Architecture\n\n```mermaid\ngraph TB\n    A[AI Client\u003Cbr\u002F>Cursor\u002FClaude\u002FWindsurf] -->|MCP Protocol| B[Python Server\u003Cbr\u002F>unreal_mcp_server_advanced.py]\n    B -->|TCP Socket| C[C++ Plugin\u003Cbr\u002F>UnrealMCP]\n    C -->|Native API| D[Unreal Engine 5.5+\u003Cbr\u002F>Editor & Runtime]\n    \n    B --> E[Advanced Tools]\n    E --> F[World Building]\n    E --> G[Physics Simulation]  \n    E --> H[Blueprint System]\n    \n    C --> I[Actor Management]\n    C --> J[Component System]\n    C --> K[Material System]\n```\n\n**Performance**: Native C++ plugin ensures minimal latency for real-time control\n**Reliability**: Robust TCP communication with automatic reconnection\n**Flexibility**: Full access to Unreal's actor, component, and Blueprint systems\n\n---\n\n## Community & Support\n\n**Join our community and get help building amazing worlds!**\n\n### Connect With Us\n- **YouTube**: [youtube.com\u002F@flopperam](https:\u002F\u002Fyoutube.com\u002F@flopperam) - Tutorials, showcases, and development updates\n- **Discord**: [discord.gg\u002F8yr1RBv](https:\u002F\u002Fdiscord.gg\u002F3KNkke3rnH) - Get help, share creations, and discuss the plugin\n- **Twitter\u002FX**: [twitter.com\u002FFlopperam](https:\u002F\u002Ftwitter.com\u002FFlopperam) - Latest news and quick updates  \n- **TikTok**: [tiktok.com\u002F@flopperam](https:\u002F\u002Ftiktok.com\u002F@flopperam) - Quick tips and amazing builds\n\n### Get Help & Share\n- **Setup Issues?** Check our [Debugging & Troubleshooting Guide](DEBUGGING.md) first\n- **Questions?** Ask in our Discord server for real-time support\n- **Bug reports?** Open an issue on GitHub with reproduction steps\n- **Feature ideas?** Join the discussion in our community channels\n\n---\n\n## License\nMIT License - Build amazing things freely.\n","## 更新日期：2026年3月25日\n---\n## Flop MCP\n\n只需一个 URL 和一个 API 密钥。如果你的 AI 工具支持 MCP，它就能立即在你正在运行的 Unreal Editor 中进行检查、搜索和构建。兼容 **Cursor、Claude Code、Windsurf、Cline、VS Code Copilot、OpenClaw** 以及其他任何 MCP 客户端。\n\n### 快速设置（远程 MCP）\n\n将 Unreal Engine 工具接入你的 IDE 的最快方式是使用托管的 **Flop MCP**，地址为 [flopperam.com\u002Fmcp](https:\u002F\u002Fflopperam.com\u002Fmcp)。无需本地服务器，也不需要安装 Python——只需一个 URL 和一个 API 密钥即可。\n\n1. 在 [flopperam.com\u002Faccount](https:\u002F\u002Fflopperam.com\u002Faccount) 获取 API 密钥。\n2. 在你的项目中安装 Unreal 插件——详情请参见 [flopperam.com\u002Fdocs](https:\u002F\u002Fflopperam.com\u002Fdocs)。前往“安装”选项卡查看具体步骤。\n3. 将配置添加到你的 IDE：\n\n**Cursor** — `.cursor\u002Fmcp.json`（项目级）或 `~\u002F.cursor\u002Fmcp.json`（全局级）：\n```json\n{\n  \"mcpServers\": {\n    \"flopperam-unreal\": {\n      \"url\": \"https:\u002F\u002Fagent.flopperam.com\u002Fmcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n**Claude Code** — 在终端中运行：\n```bash\nclaude mcp add -H \"Authorization: Bearer YOUR_API_KEY\" --transport http flopperam-unreal https:\u002F\u002Fagent.flopperam.com\u002Fmcp\n```\n\n**Cline \u002F 本地 LLMs**（Ollama、LM Studio 等）：\n```json\n{\n  \"mcpServers\": {\n    \"flopperam-unreal\": {\n      \"type\": \"streamableHttp\",\n      \"url\": \"https:\u002F\u002Fagent.flopperam.com\u002Fmcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n完成以上步骤后，在你的 IDE 中确认服务器已连接，即可开始调用。\n\n---\n\n## The Flop Agent — [flopperam.com](https:\u002F\u002Fflopperam.com\u002F)\n\nFlop MCP 为你的 IDE 提供数据。而 **The Flop Agent** 则是一个完全自主的 AI，它直接运行在 Unreal Engine 内部——能够规划多步骤工作流、编写并执行代码、从错误中恢复，并不断迭代直至任务完成。\n\n- **动态工作流**——将复杂请求分解为多个步骤，并在出现问题时自动调整。\n- **Unreal 原生推理**——优化的提示词设计、专用路由机制，以及对 UE API 和蓝图的深入理解。\n- **完整的蓝图创建与编辑**——可新建蓝图、添加变量\u002F组件\u002F事件\u002F函数，更新图表逻辑，编译并验证。\n- **世界构建**——创建材质、放置 Actor、搭建建筑，并在过程中实时验证。\n- **代码执行**——直接在编辑器内执行命令——生成 Actor、编辑蓝图、构建关卡。\n- **多模型协同**——根据任务类型选择最佳模型（Opus 用于推理，Flash 用于查询）。\n- **Unreal 内嵌聊天**——内置浏览器面板，无需切换窗口。\n- **文本\u002F图像转 3D**——提供三种质量等级（良好、高质量、极高）。\n\n支持 Unreal Engine 5.5、5.6 和 5.7。完整文档请访问 [flopperam.com\u002Fdocs](https:\u002F\u002Fflopperam.com\u002Fdocs)。\n\n\u003Cimg width=\"800\" alt=\"Flop AI 根据自然语言提示在 BP_MyPlayer2 中创建健康系统\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fflopperam_unreal-engine-mcp_readme_d77732d8f27e.png\" \u002F>\n\n\u003Cimg width=\"800\" alt=\"Flop AI 在 BP_Combat99 中构建完整的战斗系统，包含生命值、护甲、耐力、连击等功能\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fflopperam_unreal-engine-mcp_readme_eaad40cb8ca1.png\" \u002F>\n\n---\n\n# 面向 Unreal Engine 的最先进 MCP 服务器\n\n**通过自然语言控制 Unreal Engine 5.5 及更高版本**——该 MCP 服务器使 AI 客户端能够构建令人惊叹的 3D 世界和建筑杰作。借助 AI 驱动的指令，你可以创建整个城镇、中世纪城堡、现代豪宅、复杂的迷宫以及各种精巧结构。\n\n[![Unreal Engine](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FUnreal%20Engine-5.5%2B-orange.svg)](https:\u002F\u002Fwww.unrealengine.com\u002F)\n[![YouTube](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FYouTube-@flopperam-red.svg?logo=youtube)](https:\u002F\u002Fyoutube.com\u002F@flopperam)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-Join%20Server-5865F2.svg?logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002F3KNkke3rnH)\n[![Twitter](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FX-@Flopperam-1DA1F2.svg?logo=x&logoColor=white)](https:\u002F\u002Ftwitter.com\u002FFlopperam)\n[![TikTok](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FTikTok-@flopperam-000000.svg?logo=tiktok&logoColor=white)](https:\u002F\u002Ftiktok.com\u002F@flopperam)\n\n> **持续开发中**：此 MCP 服务器正处于积极开发阶段，我们会定期发布更新和改进。加入我们的 [Discord](https:\u002F\u002Fdiscord.gg\u002F3KNkke3rnH)，及时获取最新动态！\n\n## 实际演示\n观看我们的综合教程，了解完整的设置与使用方法：\n- **[完整 MCP 教程及安装指南](https:\u002F\u002Fyoutu.be\u002Fct5dNJC-Hx4)**——涵盖安装、配置及高级用法的全程演示。\n\n在我们的频道上查看更多 MCP 服务器的实际应用示例：\n- **[GPT-5 vs Claude](https:\u002F\u002Fyoutube.com\u002Fshorts\u002FxgoJ4d3d4-4)**——观看 Claude 和 GPT-5 同时竞争建造场景：Claude 打造一座巨大堡垒，而 GPT-5 则建设一座 sprawling 城市。\n- **[高级大都市生成](https:\u002F\u002Fyoutube.com\u002Fshorts\u002F6WkxCQXbCWk)**——AI 仅凭一条提示语便生成了一座拥有塔楼、街道、公园等设施，包含超过 4,000 个对象的完整大都市。\n- **[复杂迷宫与豪宅生成](https:\u002F\u002Fyoutube.com\u002Fshorts\u002FArExYGpIZwI)**——Claude 生成了一个可游玩的迷宫，以及带有翼楼、塔楼和拱门的完整豪宅群。\n\n## 特色功能\n\n### 全面蓝图可视化脚本编程\n\n**通过 AI 完全编程蓝图**，实现全面的节点创建、图表管理以及变量系统。\n\n```bash\n# 创建包含控制流、变量和函数的复杂蓝图逻辑\n> “创建一个带有健康系统的蓝图，追踪伤害并触发死亡事件”\n→ create_blueprint() + create_variable() + add_node() + connect_nodes()\n\n# 支持 6 大类共 23 种以上的节点类型：\n# 控制流：分支、比较、开关（字节\u002F枚举\u002F整数）、执行序列\n# 数据：变量获取、变量设置、数组创建\n# 类型转换：动态类型转换、类动态类型转换、字节转枚举\n# 实用工具：打印、调用函数、选择、生成 Actor\n# 专用节点：时间轴、获取数据表行、按类添加组件、自身、结点\n# 动画：播放动画、停止动画、时间轴节点\n```\n\n**高级蓝图特性：**\n- **函数管理**：创建自定义函数，设置输入输出参数，重命名或删除。\n- **变量系统**：全面属性控制（公有\u002F私有、复制、工具提示、范围、单位）。\n- **节点属性**：动态引脚管理、类型修改、语义化编辑。\n- **图表分析**：读取完整蓝图内容，分析执行流程，检查变量。\n- **连接系统**：自动类型校验下连接节点。\n\n### 世界构建与建筑设计  \n```bash\n# 构建拥有摩天大楼、飞行汽车和先进基础设施的未来感城市\n> “建造一座拥有高耸摩天大楼的巨大未来城市”\n→ create_town(town_size=\"massive\", architectural_style=\"futuristic\", building_density=0.95)\n\n# 搭建带窗户、门和屋顶的复杂多房间住宅\n> “创建一座维多利亚风格的豪宅群，包括东西两翼”\n→ construct_house(house_style=\"mansion\", width=1500, height=900)\n```\n\n### 智能迷宫\n```bash\n# 使用递归回溯法生成保证有解的迷宫\n> “制作一个15x15、高墙的迷宫”\n→ create_maze(rows=15, cols=15, wall_height=4, cell_size=250)\n```\n\n---\n\n## 完整工具库\n\n| **类别** | **工具** | **描述** |\n|------------|-----------|----------|\n| **蓝图可视化脚本** | `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多种节点类型、可完全控制属性的变量、自定义函数以及动态图管理 |\n| **蓝图分析** | `read_blueprint_content`, `analyze_blueprint_graph`, `get_blueprint_variable_details`, `get_blueprint_function_details` | 对蓝图结构、事件图表、执行流程、变量和函数进行深度检查 |\n| **世界构建** | `create_town`, `construct_house`, `construct_mansion`, `create_tower`, `create_arch`, `create_staircase` | 构建复杂的建筑结构和整个定居点 |\n| **史诗级建筑** | `create_castle_fortress`, `create_suspension_bridge`, `create_aqueduct` | 巨大的工程奇迹和中世纪堡垒 |\n| **关卡设计** | `create_maze`, `create_pyramid`, `create_wall` | 设计具有挑战性的游戏关卡和谜题 |\n| **物理与材质** | `spawn_physics_blueprint_actor`, `set_physics_properties`, `get_available_materials`, `apply_material_to_actor`, `apply_material_to_blueprint`, `set_mesh_material_color` | 创建逼真的物理模拟和材质系统 |\n| **蓝图系统** | `create_blueprint`, `compile_blueprint`, `add_component_to_blueprint`, `set_static_mesh_properties` | 可视化脚本编写和自定义Actor创建 |\n| **Actor管理** | `get_actors_in_level`, `find_actors_by_name`, `delete_actor`, `set_actor_transform`, `get_actor_material_info` | 精确控制场景中的对象并进行检查 |\n\n---\n\n## 高速搭建\n\n### 前提条件\n- **虚幻引擎5.5及以上版本**\n- **Python 3.12及以上版本**\n- **MCP客户端**（Claude Desktop、Cursor或Windsurf）\n\n### 1. 搭建选项\n\n**选项A：使用预构建项目（推荐快速上手）**\n```bash\n# 克隆仓库\ngit clone https:\u002F\u002Fgithub.com\u002Fflopperam\u002Funreal-engine-mcp.git\ncd unreal-engine-mcp\n\n# 打开预配置好的项目\n# 双击 FlopperamUnrealMCP\u002FFlopperamUnrealMCP.uproject\n# 或通过虚幻引擎启动器打开\n\n# 插件已安装并启用！\n```\n\n**选项B：将插件添加到现有项目**\n```bash\n# 将插件复制到您的项目\ncp -r UnrealMCP\u002F YourProject\u002FPlugins\u002F\n\n# 在虚幻编辑器中启用\n编辑 → 插件 → 搜索“UnrealMCP” → 启用 → 重启编辑器\n```\n\n**选项C：为所有项目安装**\n```bash\n# 复制到引擎插件文件夹（对所有项目可用）\ncp -r UnrealMCP\u002F \"C:\u002FProgram Files\u002FEpic Games\u002FUE_5.5\u002FEngine\u002FPlugins\u002F\"\n\n# 在任意项目中通过插件浏览器启用\n编辑 → 插件 → 搜索“UnrealMCP” → 启用\n```\n\n#### Mac系统的额外步骤\n如果您使用的是macOS，并且由于编译错误导致虚幻引擎无法打开项目，您需要先手动编译C++插件。具体步骤如下：\n\n##### 第一步：检查Xcode版本\n\n```bash\nxcodebuild -version\nxcrun --show-sdk-version\n```\n\n记录您的Xcode版本号（例如，“26.0.1”、“16.0”、“15.2”等）。如果您的版本高于16.0，则需要修补虚幻引擎的SDK配置。\n\n##### 第二步：修补虚幻引擎SDK配置\n\n编辑您虚幻引擎安装目录下的文件（将“UE_5.X”替换为您使用的版本）：\n\n```bash\n# 编辑路径：\n\u002FUsers\u002FShared\u002FEpic Games\u002FUE_5.X\u002FEngine\u002FConfig\u002FApple\u002FApple_SDK.json\n```\n\n更新以下值：\n\n**更改1：** 更新`MaxVersion`以支持您的Xcode版本\n```json\n{\n  \"MaxVersion\": \"YOUR_XCODE_VERSION.9.0\",  \u002F\u002F 例如，如果您使用的是Xcode 26.x，则填写“26.9.0”\n}\n```\n将`YOUR_XCODE_VERSION`替换为您在第一步中记录的Xcode主版本号。\n\n**更改2：** 为您的Xcode版本添加LLVM版本映射（添加到`AppleVersionToLLVMVersions`数组中）\n```json\n{\n  \"AppleVersionToLLVMVersions\": [\n    \"14.0.0-14.0.0\",\n    \"14.0.3-15.0.0\",\n    \"15.0.0-16.0.0\",\n    \"16.0.0-17.0.6\",\n    \"16.3.0-19.1.4\",\n    \"YOUR_XCODE_VERSION.0.0-19.1.4\"  \u002F\u002F 例如，对于Xcode 26.x，填写“26.0.0-19.1.4”\n  ]\n}\n```\n同样，将`YOUR_XCODE_VERSION`替换为您在第一步中记录的Xcode主版本号。\n\n##### 第三步：编译插件\n\n运行虚幻构建工具来编译项目：\n\n```bash\n\"\u002FUsers\u002FShared\u002FEpic Games\u002FUE_5.X\u002FEngine\u002FBuild\u002FBatchFiles\u002FMac\u002FBuild.sh\" \\\n  UnrealEditor Mac Development \\\n  -Project=\"\u002Fpath\u002Fto\u002Funreal-engine-mcp\u002FFlopperamUnrealMCP\u002FFlopperamUnrealMCP.uproject\" \\\n  -WaitMutex\n```\n\n请替换：\n- `UE_5.X`为您使用的虚幻引擎版本（例如，“UE_5.5”）\n- `\u002Fpath\u002Fto\u002Funreal-engine-mcp\u002F`为您克隆仓库的实际路径\n\n##### 第四步：打开项目\n\n编译成功后，您就可以在虚幻引擎中打开`FlopperamUnrealMCP.uproject`了。\n\n### 2. 启动MCP服务器\n\n```bash\ncd Python\nuv run unreal_mcp_server_advanced.py\n```\n\n### 3. 配置您的AI客户端\n\n将以下内容添加到您的MCP配置中：\n\n**Cursor**：`.cursor\u002Fmcp.json`\n**Claude Desktop**：`~\u002F.config\u002Fclaude-desktop\u002Fmcp.json`\n**Windsurf**：`~\u002F.config\u002Fwindsurf\u002Fmcp.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"unrealMCP\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"--directory\",\n        \"\u002Fpath\u002Fto\u002Funreal-engine-mcp\u002FPython\",\n        \"run\",\n        \"unreal_mcp_server_advanced.py\"\n      ]\n    }\n  }\n}\n```\n\n请注意，在Mac以及有时在Windows上，您可能需要将上述`mcp.json`文件中`command`字段的值“uv”替换为`uv`可执行文件的完整绝对路径。要获取该路径，请运行以下命令之一：\n- Mac：`which uv`\n- Windows：`where uv`\n\n> **设置遇到问题？** 请查看我们的[调试与故障排除指南](DEBUGGING.md)，以解决常见的MCP安装错误和配置问题。\n>\n> **想用AI编程蓝图吗？** 请参阅我们的[蓝图图形编程指南](Guides\u002Fblueprint-graph-guide.md)，学习如何以编程方式创建节点、连接和变量。\n\n### 4. 开始建造！\n\n```bash\n> “创建一座带有塔楼和城墙的中世纪城堡”\n> “生成一个带有喷泉和建筑的城镇广场”\n> “制作一个玩家需要解开的挑战性迷宫”\n```\n\n---\n\n## 架构\n\n```mermaid\ngraph TB\n    A[AI客户端\u003Cbr\u002F>Cursor\u002FClaude\u002FWindsurf] -->|MCP协议| B[Python服务器\u003Cbr\u002F>unreal_mcp_server_advanced.py]\n    B -->|TCP套接字| C[C++插件\u003Cbr\u002F>UnrealMCP]\n    C -->|原生API| D[虚幻引擎5.5+\u003Cbr\u002F>编辑器与运行时]\n    \n    B --> E[高级工具]\n    E --> F[世界构建]\n    E --> G[物理模拟]  \n    E --> H[蓝图系统]\n    \n    C --> I[Actor管理]\n    C --> J[组件系统]\n    C --> K[材质系统]\n```\n\n**性能**: 原生C++插件确保实时控制的极低延迟  \n**可靠性**: 强健的TCP通信，支持自动重连  \n**灵活性**: 完全访问虚幻引擎的Actor、组件和蓝图系统\n\n---\n\n## 社区与支持\n\n**加入我们的社区，一起打造精彩的世界吧！**\n\n### 与我们联系\n- **YouTube**: [youtube.com\u002F@flopperam](https:\u002F\u002Fyoutube.com\u002F@flopperam) - 教程、作品展示及开发更新\n- **Discord**: [discord.gg\u002F8yr1RBv](https:\u002F\u002Fdiscord.gg\u002F3KNkke3rnH) - 获取帮助、分享创作并讨论插件\n- **Twitter\u002FX**: [twitter.com\u002FFlopperam](https:\u002F\u002Ftwitter.com\u002FFlopperam) - 最新消息与快速更新  \n- **TikTok**: [tiktok.com\u002F@flopperam](https:\u002F\u002Ftiktok.com\u002F@flopperam) - 快速技巧与精彩作品\n\n### 获取帮助与分享\n- **设置问题？** 请先查看我们的[调试与故障排除指南](DEBUGGING.md)\n- **有疑问？** 欢迎在Discord服务器中提问，我们将提供实时支持\n- **Bug报告？** 请在GitHub上提交包含复现步骤的问题\n- **功能建议？** 欢迎在社区频道中参与讨论\n\n---\n\n## 许可证\nMIT许可证 - 自由地构建精彩内容。","# unreal-engine-mcp 快速上手指南\n\n`unreal-engine-mcp` 是一个强大的 MCP（Model Context Protocol）服务器，允许 AI 助手（如 Cursor、Claude Code、Windsurf 等）通过自然语言直接控制 Unreal Engine 5.5+ 编辑器。它可以自动创建蓝图、构建建筑、生成迷宫以及管理场景资产。\n\n## 环境准备\n\n在开始之前，请确保满足以下系统要求：\n\n*   **Unreal Engine**: 版本 5.5 或更高（支持 5.5, 5.6, 5.7）。\n*   **Python**: 版本 3.12 或更高。\n*   **MCP 客户端**: 已安装支持的 IDE 或工具（推荐 Cursor, Claude Desktop, Windsurf, Cline 等）。\n*   **操作系统**: Windows 或 macOS。\n    *   *macOS 用户注意*: 若遇到编译错误，需确保 Xcode 版本与 UE SDK 配置兼容（详见原文档 Mac 部分）。\n\n## 安装步骤\n\n你可以选择**远程托管模式**（最快，无需本地配置 Python 服务）或**本地源码模式**。\n\n### 方案 A：远程托管模式（推荐，最快上手）\n\n此方案无需本地运行 Python 服务器，只需一个 URL 和 API Key 即可连接。\n\n1.  **获取 API Key**\n    访问 [flopperam.com\u002Faccount](https:\u002F\u002Fflopperam.com\u002Faccount) 注册并获取你的 API Key。\n\n2.  **安装 Unreal 插件**\n    *   下载插件文件（参考官方文档 [flopperam.com\u002Fdocs](https:\u002F\u002Fflopperam.com\u002Fdocs)）。\n    *   将插件文件夹复制到你的项目目录：\n        ```bash\n        cp -r UnrealMCP\u002F YourProject\u002FPlugins\u002F\n        ```\n    *   打开 Unreal Editor，进入 `Edit` → `Plugins`，搜索 \"UnrealMCP\" 并启用，然后重启编辑器。\n\n3.  **配置 MCP 客户端**\n    根据你的 IDE 添加以下配置（将 `YOUR_API_KEY` 替换为你的实际密钥）：\n\n    **Cursor** (编辑 `.cursor\u002Fmcp.json` 或 `~\u002F.cursor\u002Fmcp.json`):\n    ```json\n    {\n      \"mcpServers\": {\n        \"flopperam-unreal\": {\n          \"url\": \"https:\u002F\u002Fagent.flopperam.com\u002Fmcp\",\n          \"headers\": {\n            \"Authorization\": \"Bearer YOUR_API_KEY\"\n          }\n        }\n      }\n    }\n    ```\n\n    **Claude Code** (在终端运行):\n    ```bash\n    claude mcp add -H \"Authorization: Bearer YOUR_API_KEY\" --transport http flopperam-unreal https:\u002F\u002Fagent.flopperam.com\u002Fmcp\n    ```\n\n    **Cline \u002F 本地 LLM 客户端**:\n    ```json\n    {\n      \"mcpServers\": {\n        \"flopperam-unreal\": {\n          \"type\": \"streamableHttp\",\n          \"url\": \"https:\u002F\u002Fagent.flopperam.com\u002Fmcp\",\n          \"headers\": {\n            \"Authorization\": \"Bearer YOUR_API_KEY\"\n          }\n        }\n      }\n    }\n    ```\n\n### 方案 B：本地源码模式（适合开发者调试）\n\n1.  **克隆仓库**\n    ```bash\n    git clone https:\u002F\u002Fgithub.com\u002Fflopperam\u002Funreal-engine-mcp.git\n    cd unreal-engine-mcp\n    ```\n\n2.  **设置项目**\n    *   双击打开 `FlopperamUnrealMCP\u002FFlopperamUnrealMCP.uproject`。\n    *   或者将 `UnrealMCP` 文件夹复制到你现有项目的 `Plugins` 目录下并在编辑器中启用。\n\n3.  **启动 MCP 服务器**\n    确保 Unreal Editor 正在运行该项目，然后在终端启动 Python MCP 服务（具体启动命令需参考仓库内的 `requirements.txt` 安装依赖后运行主脚本，通常涉及 `python -m uvicorn` 或类似入口，此处建议使用方案 A 以简化流程）。\n\n## 基本使用\n\n配置完成后，确保 Unreal Editor 处于运行状态且插件已加载。在你的 AI 编辑器（如 Cursor 聊天窗口）中，确认 MCP 服务器状态为 \"Connected\"。\n\n你可以直接使用自然语言下达指令，AI 将自动调用工具在引擎中执行操作。\n\n### 使用示例\n\n**示例 1：创建复杂的蓝图逻辑**\n> \"Create a Blueprint with a health system that tracks damage and triggers a death event\"\n>\n> *效果：AI 会自动创建一个蓝图，添加生命值变量，编写伤害计算逻辑，并连接死亡事件节点。*\n\n**示例 2：构建大型建筑**\n> \"Build a massive futuristic city with towering skyscrapers\"\n>\n> *效果：调用 `create_town` 工具，生成具有高密度未来风格建筑的城镇。*\n\n**示例 3：生成游戏关卡**\n> \"Make a 15x15 maze with high walls\"\n>\n> *效果：调用 `create_maze` 工具，使用递归回溯算法生成一个可解的迷宫。*\n\n**示例 4：物理与材质操作**\n> \"Spawn a physics actor and apply a red metal material to it\"\n>\n> *效果：生成带有物理属性的 Actor，并自动查找并应用红色金属材质。*\n\n---\n*提示：更多高级功能（如自主代理工作流、多模型路由）请访问 [flopperam.com](https:\u002F\u002Fflopperam.com\u002F) 查看完整文档。*","一位独立游戏开发者正在为一款中世纪题材的动作 RPG 快速构建核心战斗系统，需要在 Unreal Engine 5.6 中实现包含血量、耐力、连击判定及受伤反馈的完整逻辑。\n\n### 没有 unreal-engine-mcp 时\n- **蓝图编写繁琐**：开发者需手动在蓝图编辑器中拖拽数十个节点来连接变量与事件，极易因连线错误导致编译失败。\n- **上下文切换频繁**：遇到 API 遗忘或逻辑卡顿时，必须离开引擎去浏览器搜索文档，再切回引擎尝试，打断心流。\n- **迭代试错成本高**：调整数值或修改状态机逻辑需要反复手动删除旧节点、创建新变量并重新连线，耗时且容易遗漏细节。\n- **复杂系统构建难**：单人开发难以在短时间内同时兼顾美术资源放置与复杂的底层代码逻辑，往往顾此失彼。\n\n### 使用 unreal-engine-mcp 后\n- **自然语言生成蓝图**：直接在 Cursor 或 Claude Code 中输入“创建包含血量和耐力条的战斗蓝图”，unreal-engine-mcp 自动在引擎内生成并连接好所有节点，即时编译通过。\n- **IDE 内闭环开发**：开发者无需离开代码编辑器，AI 即可通过 MCP 协议直接读取当前场景状态并执行修改指令，实现无缝协作。\n- **自主纠错与迭代**：若逻辑有误，unreal-engine-mcp 能自动分析错误日志，自主调整蓝图结构并重新验证，将数小时的调试工作压缩至几分钟。\n- **全栈自动化构建**：一条指令即可同时完成演员生成、材质赋予及逻辑绑定，让开发者能专注于玩法创意而非重复性劳动。\n\nunreal-engine-mcp 将原本需要数天手工拼凑的复杂系统构建过程，转化为分钟级的自然语言对话，极大释放了开发者的创造力。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fflopperam_unreal-engine-mcp_cf5d1f07.png","flopperam","Flopperam","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fflopperam_23961eed.png","Making educational content on game development and software",null,"flopperam.com","https:\u002F\u002Fgithub.com\u002Fflopperam",[81,85,89,93],{"name":82,"color":83,"percentage":84},"C++","#f34b7d",59.2,{"name":86,"color":87,"percentage":88},"Python","#3572A5",40.2,{"name":90,"color":91,"percentage":92},"C#","#178600",0.5,{"name":94,"color":95,"percentage":96},"C","#555555",0,825,159,"2026-04-18T00:29:25","Windows, macOS","未说明（依赖 Unreal Engine 5.5+ 的官方图形卡要求）","未说明（依赖 Unreal Engine 5.5+ 的官方内存要求）",{"notes":104,"python":105,"dependencies":106},"该工具主要通过远程托管服务（Flop MCP）运行，本地无需安装 Python 服务器即可使用基础功能。若选择本地部署插件，Windows 用户可直接使用预构建项目；macOS 用户若遇到编译错误，需手动配置 Xcode 版本并修补 Unreal Engine 的 SDK 配置文件（Apple_SDK.json），然后使用 Unreal Build Tool 编译 C++ 插件。支持 Unreal Engine 5.5、5.6 和 5.7 版本。","3.12+",[107,108],"Unreal Engine 5.5+","MCP Client (e.g., Cursor, Claude Code, Windsurf)",[13,45,110],"其他","2026-03-27T02:49:30.150509","2026-04-18T17:04:05.183991",[],[]]