Unreal

安装配置

{
    "mcpServers": {
        "unrealMCP": {
            "command": "uv",
            "args": [
                "--directory",
                "<path/to/the/folder/PYTHON>",
                "run",
                "unreal_mcp_server.py"
            ]
        }
    }
}

README 摘要

# Model Context Protocol for Unreal Engine unreal-mcp [](https://opensource.org/licenses/MIT) [](https://www.unrealengine.com) [](https://www.python.org) [](https://github.com/chongdashu/unreal-mcp) This project enables AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP). ## ⚠️ Experimental Status This project is currently in an **EXPERIMENTAL** state. The API, functionality, and implementation details are subject to significant changes. While we encourage testing and feedback, please be aware that: - Breaking changes may occur without notice - Features may be incomplete or unstable - Documentation may be outdated or missing - Production use is not recommended at this time ## 🌟 Overview The Unreal MCP integration provides comprehensive tools for controlling Unreal Engine through natural language: | Category | Capabilities | |----------|-------------| | **Actor Management** | • Create and delete actors (cubes, spheres, lights, cameras, etc.)• Set actor transforms (position, rotation, scale)• Query actor properties and find actors by name• List all actors in the current level | | **Blueprint Development** | • Create new Blueprint classes with custom components• Add and configure components (mesh, camera, light, etc.)• Set component properties and physics settings• Compile Blueprints and spawn Blueprint actors• Create input mappings for player controls | | **Blueprint Node Graph** | • Add event nodes (BeginPlay, Tick, etc.)• Create function call nodes and connect them• Add variables with custom types and default values• Create component and self references• Find and manage nodes in the graph | | **Editor Control** | • Focus viewport on specific actors or locations• Control viewport camera orientation and distance | All these capabilities are accessible through natural language commands via AI assistants, making it easy to automate and control Unreal Engine workflows. ## 🧩 Components ### Sample Project (MCPGameProject) `MCPGameProject` - Based off the Blank Project, but with the UnrealMCP plugin added. ### Plugin (UnrealMCP) `MCPGameProject/Plugins/UnrealMCP` - Native TCP server for MCP communication - Integrates with Unreal Editor subsystems - Implements actor manipulation tools - Handles command execution and response handling ### Python MCP Server `Python/unreal_mcp_server.py` - Implemented in `unreal_mcp_server.py` - Manages TCP socket connections to the C++ plugin (port 55557) - Handles command serialization and response parsing - Provides error handling and connection management - Loads and registers tool modules from the `tools` directory - Uses the FastMCP library to implement the Model Context Protocol ## 📂 Directory Structure - **MCPGameProject/** - Example Unreal project - **Plugins/UnrealMCP/** - C++ plugin source - **Source/UnrealMCP/** - Plugin source code - **UnrealMCP.uplugin** - Plugin definition - **Python/** - Python server and tools - **tools/** - Tool modules for actor, editor, and blueprint operations - **scripts/** - Example scripts and demos - **Docs/** - Comprehensive documentation - See [Docs/README.md](Docs/README.md...