MCP Integration

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:

1. Install Claude Desktop
2. The plugin’s MCP extension is located at: Plugins/BpGeneratorUltimate/Content/Python/extensions/unreal-handshake/
3. Configure Claude Desktop to use this extension
4. 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:

1. Install Claude Code: npm install -g @anthropic-ai/claude-code
2. With UE running and the plugin active, Claude Code can use MCP tools
3. 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.