日本語版はこちら / Japanese

An MCP (Model Context Protocol) server that bridges AI assistants (Claude) with Unreal Engine 5. Control Blueprints, design levels, create UI, and build AI systems using natural language.

See FEATURE_STATUS.md for detailed feature documentation.

• Unreal Engine 5.5+
• Python 3.11+ with uv
• Claude Desktop or Claude Code

# 1. Clone the repository
git clone https://github.com/SpirrowGames/spirrow-unrealwise.git
cd spirrow-unrealwise

# 2. Install Python dependencies
cd Python && uv sync

# 3. Copy the UE plugin to your project
# Copy: MCPGameProject/Plugins/SpirrowBridge → YourProject/Plugins/

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "spirrow-unrealwise": {
      "command": "uv",
      "args": ["--directory", "C:/path/to/spirrow-unrealwise/Python", "run", "python", "unreal_mcp_server.py"],
      "env": {
        "SPIRROW_UE_HOST": "127.0.0.1",
        "SPIRROW_UE_PORT": "8080"
      }
    }
  }
}

1. Launch Unreal Editor with SpirrowBridge plugin enabled
2. Open Claude Desktop and try: "List all actors in the current level"

"Create an Actor Blueprint called BP_Enemy"

"Add a SphereComponent to BP_Enemy with radius 500"

"Create a Widget Blueprint WBP_HUD and add a centered ProgressBar"

"Create a BehaviorTree BT_Enemy and add a Selector node"

"Set up AIPerception with sight sense, 2000 unit range, 90 degree FOV"

spirrow-unrealwise/
├── Python/                    # MCP Server
│   ├── unreal_mcp_server.py   # Main server entry
│   ├── tools/                 # Tool definitions (12 modules)
│   └── tests/                 # Test suite
├── MCPGameProject/Plugins/    # UE Plugin
│   └── SpirrowBridge/         # Editor module
├── Docs/                      # Documentation
└── templates/                 # Material templates

cd Python && python tests/run_tests.py

See Docs/PATTERNS.md for implementation patterns and guidelines.

v0.9.0 (Beta) - 2026-02-15

• BehaviorTree Health Check: detect_broken_bt_nodes and fix_broken_bt_nodes
• Automatically detect and remove broken nodes (null NodeInstance) from BehaviorTrees
• Fixes the "red error decorator" issue after compilation failures

v0.8.11 (Beta) - 2026-01-26

• Added find_cpp_function_in_blueprints - Search for function callers across Blueprints

v0.8.10 (Beta) - 2026-01-12

• AI Image Generation integration (Stable Diffusion Forge)
• Asset utility tools (texture import, folder management)

v0.8.0 (Beta) - 2026-01-06

• Phase H: AIPerception & EQS support (11 tools)
• Complete AI system coverage (28 tools total)

See Docs/CHANGELOG.md for full history.

Contributions are welcome! Please feel free to submit issues and pull requests.

MIT License - see LICENSE for details.

• Model Context Protocol
• Unreal Engine Documentation
• Claude