MCP Integration
MCP Integration
V1 Documentation - Under Heavy Rework. Some sections may be incomplete. For the latest info, check the FAB listing or Discord.
The plugin runs an MCP (Model Context Protocol) server that allows external AI tools to control the Unreal Editor.
What is MCP?
MCP is an open protocol that lets AI assistants call tools in external systems. The plugin’s MCP server exposes all tool categories (Blueprint creation, asset management, Niagara, materials, etc.) over a TCP connection.
MCP Server
The server starts automatically when the plugin loads.
- Port: 9877 (tries 9877-9886 if the base port is busy)
- Protocol: TCP with JSON messages
- Authentication: None (localhost only)
Claude Desktop Integration
A Claude Desktop extension manifest ships with the plugin. To use it:
- Install Claude Desktop
- The plugin’s MCP extension is located at:
Plugins/BpGeneratorUltimate/Content/Python/extensions/unreal-handshake/ - Configure Claude Desktop to use this extension
- When both UE and Claude Desktop are running, Claude can execute any of the plugin’s tools
Claude Code Integration
Claude Code (the CLI) can connect to the MCP server the same way:
- Install Claude Code:
npm install -g @anthropic-ai/claude-code - With UE running and the plugin active, Claude Code can use MCP tools
- The plugin also supports running Claude Code as an in-editor agent (see AI Agents)
What External Tools Can Do
Any MCP-compatible client connected to the server has access to all tool categories:
- Create and modify Blueprints
- Spawn and configure actors in the level
- Create materials, Niagara systems, animations
- Run project scans and queries
- Generate textures and 3D models
- Compile Blueprints and read build errors
- Execute Python scripts
- And everything else listed in Tool Categories
Multiple UE Instances
The MCP server tries ports 9877 through 9886, so up to 10 UE editor instances can run simultaneously, each with its own MCP server on a different port.