Add Unity MCP One-Click Setup

[6years2Roi]

Unity MCP One-Click Setup - Public Distribution Enhancement

Summary

This PR adds a complete one-click setup solution for Unity MCP that eliminates setup friction and makes the project suitable for public distribution.

Problem Solved

Current Unity MCP setup requires:

• Manual Git installation and configuration
• Complex multi-step Python environment setup
• Separate server and bridge management
• Technical knowledge of command-line tools

This creates barriers for:

• Unity developers wanting to try Unity MCP
• Public project distribution
• Non-technical users
• Educational/demo scenarios

Solution

One-Click Universal Launcher that:

• ✅ Bundles everything - No external dependencies
• ✅ Smart Git fallback - Works with or without Git
• ✅ Auto environment setup - Creates Python venv automatically
• ✅ Combined services - Starts server + bridge together
• ✅ WSL compatible - Network IP auto-detection
• ✅ Self-contained - All files in dedicated folder

What's Changed

New Files Added:

• one-click-setup/ClaudeCodeBridge/start-unity-mcp-universal.bat - Universal launcher
• one-click-setup/ClaudeCodeBridge/unity-mcp/UnityMcpServer/ - Bundled server
• one-click-setup/ClaudeCodeBridge/README.md - Setup instructions

Enhanced Unity Bridge:

• Smart server detection (local vs git-based)
• Better error messages and guidance
• Support for bundled server installations

User Experience

Before:

1. Install Git for Windows
2. Clone unity-mcp repository
3. Set up Python virtual environment
4. Install dependencies manually
5. Configure paths and settings
6. Start server manually
7. Start bridge manually
8. Hope everything connects

After:

1. Double-click start-unity-mcp-universal.bat
2. Use Claude Code immediately!

Technical Implementation

Universal Launcher Architecture:

1. Environment Validation - Checks Unity, Python, components
2. Python Environment - Auto-creates isolated venv
3. Dependency Installation - From bundled requirements.txt
4. Combined Service Management - Server + bridge lifecycle
5. Error Handling - Clear guidance for common issues

Smart Fallback System:

• Priority 1: Use bundled local installation (fastest)
• Priority 2: Git-based installation (if available)
• Priority 3: Clear guidance for manual setup

Benefits

For Users:

• 30-second setup instead of 30-minute setup
• Works offline after Python install
• No Git knowledge required
• Self-contained project distribution

For Unity MCP Project:

• Lower barrier to entry - More users can try it
• Better public distribution - Suitable for sharing projects
• Reduced support overhead - Fewer setup-related issues
• Educational friendly - Great for demos and tutorials

Testing

✅ Fresh Windows install - Tested without Git
✅ WSL environment - Network IP detection working
✅ Unity integration - Full GameObject manipulation confirmed
✅ Claude Code compatibility - HTTP API responding correctly
✅ Error handling - Clear messages for missing requirements

Backward Compatibility

• ✅ Existing installations continue to work unchanged
• ✅ Git-based workflows still supported
• ✅ No breaking changes to existing APIs
• ✅ Optional enhancement - doesn't affect current users

Files Changed

• UnityMcpBridge/Editor/Helpers/ServerInstaller.cs - Added smart fallback
• Added complete one-click setup package

Demo

The contribution includes a working example that:

1. Creates Python environment: unity-mcp-env-windows
2. Installs dependencies: httpx, mcp, flask
3. Starts Unity MCP Server on port 6500
4. Starts Claude Code Bridge on port 6501
5. Connects to Unity Bridge on port 6400
6. Enables immediate Claude Code ↔ Unity communication

Future Considerations

This foundation enables:

• Cross-platform launchers (Linux/macOS)
• Unity Package Manager integration
• Automated project templates
• Educational content creation

---

Ready for public distribution and eliminates setup friction for Unity MCP adoption! 🚀