MCP 允许 AI 代理控制 Unreal
概览
[discord-shield]： https://img.shields.io/badge/Discord-Join-5865F2?style=flat&logo=discord&logoColor=white [discord-url]： https://discord.gg/ThkpVxdzet 我现在正在添加更多工具，并清理代码库，计划在主插件之外方便地扩展工具 这还在不断完善中，我需要清理很多东西!!!! 另外，我只用Windows，所以不知道Mac/Unix怎么设置 UnrealMCP 是一个非官方的 Unreal Engine 插件，旨在用 AI 工具控制 Unreal Engine。它在 Unreal Engine 内实现了机器控制协议（MCP），允许外部 AI 系统以程序方式与 Unreal 环境交互和操作。 我几天前才刚了解MCP，所以不太熟悉，还在学习中，刚开始可能会比较难。我用https://github.com/ahujasid/blender-mcp作为参考实现了这个功能，桌面版依赖Claude。
概述（AI 翻译）
[discord-shield]： https://img.shields.io/badge/Discord-Join-5865F2?style=flat&logo=discord&logoColor=white [discord-url]： https://discord.gg/ThkpVxdzet
非常快要回购
我现在正在添加更多工具，并清理代码库， 我计划在主插件之外提供简单的工具扩展
这还在不断完善中，我需要清理很多东西!!!
另外，我只用Windows，所以不知道Mac/Unix怎么设置
概述
UnrealMCP 是一个非官方的 Unreal Engine 插件，旨在用 AI 工具控制 Unreal Engine。它在 Unreal Engine 内实现了机器控制协议（MCP），允许外部 AI 系统以程序方式与 Unreal 环境交互和操作。
我几天前才知道MCP，所以不太熟悉，还在学习中，刚开始可能会比较难。 我用 https://github.com/ahujasid/blender-mcp 作为参考实现了这个功能，桌面版依赖 Claude。它可能适用于其他型号，也可能不适用，如果你尝试过，请告诉我！
⚠️ 免责声明
这个插件允许AI代理直接修改你的虚幻引擎项目。
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
UnrealMCP Plugin
VERY WIP REPO
I’m working on adding more tools now and cleaning up the codebase, I plan to allow for easy tool extension outside the main plugin
This is very much a work in progress, and I need to clean up a lot of stuff!!!
Also, I only use windows, so I don’t know how this would be setup for mac/unix
Overview
UnrealMCP is an Unofficial Unreal Engine plugin designed to control Unreal Engine with AI tools. It implements a Machine Control Protocol (MCP) within Unreal Engine, allowing external AI systems to interact with and manipulate the Unreal environment programmatically.
I only just learned about MCP a few days ago, so I’m not that familiar with it, I’m still learning so things might be initially pretty rough. I’ve implemented this using https://github.com/ahujasid/blender-mcp as a reference, which relies on claude for desktop. It may or may not work with other models, if you experiment with any, please let me know!
⚠️ DISCLAIMER
This plugin allows AI agents to directly modify your Unreal Engine project. While it can be a powerful tool, it also comes with risks:
- AI agents may make unexpected changes to your project
- Files could be accidentally deleted or modified
- Project settings could be altered
- Assets could be overwritten
IMPORTANT SAFETY MEASURES:
- Always use source control (like Git or Perforce) with your project
- Make regular backups of your project
- Test the plugin in a separate project first
- Review changes before committing them
By using this plugin, you acknowledge that:
- You are solely responsible for any changes made to your project
- The plugin author is not responsible for any damage, data loss, or issues caused by AI agents
- You use this plugin at your own risk
Features
- TCP server implementation for remote control of Unreal Engine
- JSON-based command protocol for AI tools integration
- Editor UI integration for easy access to MCP functionality
- Comprehensive scene manipulation capabilities
- Python companion scripts for client-side interaction
Roadmap
These are what I have in mind for development as of 3/14/2025 I’m not sure what’s possible yet, in theory anything, but it depends on how good the integrated LLM is at utilizing these tools.
- [X] Basic operations working
- [X] Python working
- [X] Materials
- [ ] User Extensions (in progress)
- [ ] Asset tools
- [ ] Blueprints
- [ ] Niagara VFX
- [ ] Metasound
- [ ] Landscape (I might hold off on this because Epic has mentioned they are going to be updating the landscape tools)
- [ ] Modeling Tools
- [ ] PCG
Requirements
- Unreal Engine 5.5 (I have only tested on this version, may work with earlier, but no official support)
- C++ development environment configured for Unreal Engine
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": {
"unreal": {
"command": "C:\\UnrealMCP_Project\\Plugins\\UnrealMCP\\MCP\\run_unreal_mcp.bat",
"args": []
}
}
}