
UnrealMCP — AI Bridge for Unreal Engine 5
io.github.aadeshrao123由 GitHub 账号 aadeshrao123 发布v1.3.1更新于 Oct 24, 2026
Control the Unreal Engine 5 editor from any MCP client: Blueprints, materials, Niagara.
发布方自己的服务:Engine Travel Platform
概览
把 MCP 客户端连接到 Unreal Engine 5 编辑器,让助手创建和编辑蓝图、材质、Niagara 特效、关卡与资产。
- 可以做什么
- 搜索、导入、复制、重命名、删除和保存资产,读取与设置资产属性
- 创建并编译蓝图,管理变量、函数与图表节点
- 构建和检查材质图表、材质实例与材质函数
- 增删改数据表行与数据资产,包括 Mass Config 特性
- 生成、变换和删除 Actor,查询关卡信息并截取视口截图
- 编写 Niagara 系统、发射器、模块、渲染器与暂存模块,构建 StateTree、增强输入与 UMG 控件资产,录制并分析性能追踪
- 适用场景
- 适合在 Unreal Engine 5 项目中,让助手代劳重复性的编辑器操作,例如生成蓝图、连接材质或 Niagara 图表、编辑数据表、摆放 Actor,而不必手动点击编辑器。
- 运行要求
- 以本地 stdio 进程运行:需安装 unrealmcp Python 包(Python 3.10+),并把 UnrealMCP 插件克隆到项目的 Plugins 目录。需要 Unreal Engine 5.7(较早的 5.x 版本或许可用),并启用 PythonScriptPlugin、EditorScriptingUtilities 和 EnhancedInput 插件。命令生效时编辑器需处于打开状态。未声明任何 API 密钥或环境变量。
安装
在 SourceWeft 中
- 打开 控制台中的 UnrealMCP — AI Bridge for Unreal Engine 5,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
UnrealMCP — AI Bridge for Unreal Engine 5
Control the Unreal Engine 5 editor from Claude Code, Cursor, Windsurf, or any MCP client. Build materials, wire Blueprint graphs, author Niagara systems, spawn actors, edit data tables and profile performance, all by asking for it. 288 commands across 15 categories, no leaving your terminal.
[License: MPL 2.0] [UE 5.3+] [MCP] [Pro version]
This is the community edition
It is stable and feature complete for what it covers. It is not abandoned, and it is not in active development either: new subsystem work now goes into CodeFizz Editor Agent, the maintained commercial build. Everything here keeps working, issues still get read, and the MPL 2.0 licence is permanent.
If you want Control Rig, PCG, Sequencer, Mutable, Procedural Vegetation, audio and MetaSounds, Behavior Trees and EQS, or packaged binaries for UE 5.6 / 5.7 / 5.8, that lives in Pro.
Community edition vs Pro
See the full command list → · Docs · 3 day free trial
Use Claude Code? Install Pro as a Claude Code plugin, then ask Claude to "set up CodeFizz":
Already on UE 5.8? Epic now ships a first-party MCP server in 5.8 (Experimental, localhost only). It is worth trying before you buy anything. This repo and Pro both also cover 5.6 and 5.7, which Epic's does not.
Two ways to use this repo
Both talk to the same C++ plugin inside the editor. Use whichever fits your workflow, or both.
Quick Start
Option A: CLI (Recommended for Claude Code)
That's it. No Python, no config files, no MCP setup.
Option B: MCP Server (For Cursor, Windsurf, etc.)
How It Works
The C++ plugin runs inside the editor and exposes 288 commands over TCP. The CLI and MCP server are two different front doors to the same plugin.
CLI Reference
Installation
Platforms: Windows (x64), macOS (Intel + Apple Silicon), Linux (x64 + ARM64)
Setup
Usage
Help & Discovery
Global Flags
Key Commands
Assets
Blueprints
Materials
Data Tables
Actors & Level
Performance Profiling
Enhanced Input
Niagara VFX
StateTree
Mass Config Traits (Surgical Editing)
Widgets (UMG)
Diagnostics
MCP Server Setup
For AI tools that use the Model Context Protocol (Cursor, Windsurf, VS Code, etc.).
Requirements
- Unreal Engine 5.7 (tested on 5.7, may work on earlier 5.x versions)
- Python 3.10+
- UE5 Plugins (enabled automatically by the
.uplugin):PythonScriptPluginEditorScriptingUtilitiesEnhancedInput
Install
Setup Script (Alternative to Manual Config)
The setup script installs the unrealmcp pip package and creates the MCP config for your AI tool automatically.
Windows:
macOS / Linux:
The script asks where to create the MCP config:
Configure Your AI Tool
Claude Code — .mcp.json (project root)
Cursor — .cursor/mcp.json
VS Code / Copilot — .vscode/mcp.json
Windsurf — ~/.codeium/windsurf/mcp_config.json
Gemini CLI — .gemini/settings.json
JetBrains / Rider — .junie/mcp/mcp.json
Zed — ~/.config/zed/settings.json
Amazon Q — .amazonq/mcp.json
All 288 Commands
Core (2)
Asset Management (16)
Blueprints (22)
Materials (35)
Data Tables (8)
Data Assets (12)
Actors & Level (19)
Enhanced Input (21)
Widgets — UMG (11)
Niagara VFX (96)
End-to-end Niagara authoring — read the full stack, mutate any binding (top-level or nested), author scratch-pad dynamic inputs from scratch, spawn arbitrary graph nodes including data-interface member functions, and discover every valid option the editor's dropdowns expose. Built on Niagara's exported ViewModel / Stack Graph APIs with safe replication of non-exported helpers.
Systems
Emitters
Modules (Spawn / Update / Render stacks)
Stack Input Binding Loop
Parameters & Bindings
Renderers
Scratch Pad — CRUD & Apply
Script Properties (Details Panel)
Script Parameters (Input / Output)
Graph Introspection
Graph Node CRUD
Pin Management
Custom HLSL
Events & Simulation Stages
Level Spawning
Discovery (zero-guess authoring)
StateTree (33, NEW)
Read and author StateTree assets — states, tasks, evaluators, transitions, conditions, parameters, and bindings. Schema-aware: works with both StateTreeSchemaBase and Mass schema variants.
Reading
Authoring
Modification
Removal
Discovery
Performance Profiling (3)
Debug (2)
Usage Examples
These work with both the CLI and MCP server. With the CLI, the AI calls ue-cli via Bash. With MCP, the AI calls tools directly.
Create a Material
The AI will call create_material, then build_material_graph to wire up constant nodes to Base Color, Metallic, and Roughness pins.
Spawn Actors
The AI will call spawn_actor with actor_type: "PointLight" five times with calculated positions.
Blueprint Creation
The AI will use create_blueprint, add_component_to_blueprint, add_event_node, add_blueprint_node, and connect_blueprint_nodes.
Profile Performance
The AI will call performance_start_trace, wait, performance_stop_trace, then performance_analyze_insight with query: "diagnose".
Data Table Management
The AI will call get_data_table_schema, then add_data_table_row with the appropriate data.
Configuration
Custom Port
Add to Config/DefaultEngine.ini:
Environment Variable
Multiple Editor Instances
Each editor picks a unique port automatically. The CLI and MCP server read the port from Saved/UnrealMCP/port.txt. Use --port flag or UNREAL_MCP_PORT env var to target a specific instance.
Architecture
Plugin Structure
Communication Protocol
TCP with length-prefix framing:
Request: {"type": "command_name", "params": {...}}
Response: {"status": "success", "result": {...}}
Adding Custom Commands
CLI Side (Go)
Add a CommandSpec to the appropriate cmd/*.go file:
MCP Side (Python)
Create a new file in unrealmcp/tools/:
Register it in unrealmcp/tools/__init__.py:
C++ Side
Add a command handler in Source/UnrealMCPBridge/Private/Commands/ and register it in ExecuteCommand().
Supported AI Tools
Troubleshooting
Releases & Distribution
Releases are automated via GitHub Actions. Push a tag to trigger:
Contributing
- Bug? Open an issue
- Feature idea? Open an issue
- Code? Fork, make changes, open a PR
See CONTRIBUTING.md for guidelines.
Enterprise & Studio Integration
Need Unreal MCP integrated into your studio's production pipeline? I work directly with game studios to build custom AI-assisted workflows on top of this tool.
What I offer:
- Pipeline Integration — Set up Unreal MCP within your existing build system, CI/CD, and team workflow so every artist and developer can use AI assistants with your Unreal project out of the box
- Custom Tool Development — Build MCP commands tailored to your studio's proprietary formats, internal tools, and specific production needs that the open-source version doesn't cover
- AI Workflow Design — Design and implement how your team uses AI assistants (Claude, Cursor, Copilot) with Unreal Engine — from material creation to level design to asset pipelines
- Advanced Material & Substrate Systems — Procedural material generation, Substrate workflows, complex shader pipelines — fully automated through MCP
Get in touch:
- Email: [email protected]
- LinkedIn: linkedin.com/in/aadeshyadav
- Discord:
destroyerpal - Portfolio: aadeshyadav.vercel.app
Custom Development & Support
Need help with your Unreal project? I'm available for contract work across the full UE5 C++ stack, from gameplay and multiplayer to editor tooling and Mass Entity systems. See SUPPORT.md for details.
[email protected] · LinkedIn · Portfolio · Discord: destroyerpal
License
MPL-2.0 — see LICENSE for details.
来源:README.md,提交 f204058
工具
0版本历史
1- v1.3.1最新Sep 16, 2026
评分
已满足适用检查项的 50%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
其他 Engine 集成
Engine Travel Platform
com.engine官方发布者
远程 MCP 服务器,让助手在 Engine 中搜索并预订酒店、缩短或取消住宿,并查询支持工单。

Plunder & Riffle Meme Engine
由 GitHub 账号 davenamovich 发布
Memes, ads and Jobless Joe shows from one prompt: a preview page first, an MP4 after approval.
Pegasus Alpha
io.pegasusalpha
面向金融分析的 AI 股票研究引擎远程 MCP 端点,为助手提供带引用和截止日期的论断、链条与情景。

MCP Monetize - Drop-in Billing & Capability Token Engine
由 GitHub 账号 RitualDev-Lab 发布
一个可直接嵌入的计费与付费墙中间件库,让 MCP 服务器作者按工具调用次数或订阅向用户收费。

Scope | Project Management by Samay Wadhwani
由 GitHub 账号 SamayW 发布
Samay Wadhwani 的 Scope 让助手编写 HTML 并将其渲染为视频,支持字幕、动态图形和 MP4 输出。