xuunity-mcp

# XUUnity MCP

XUUnity MCP, full technical name XUUnity Light Unity MCP, is a lightweight Unity MCP server for safe Unity Editor automation.

It connects MCP-compatible AI clients such as Cursor, Claude Code, Claude Desktop, Windsurf, Codex-style agents, and custom LLM agents to Unity Editor through a host-side MCP server and an editor-only Unity package.

Primary use cases:
- Unity Editor status and health checks
- Unity console tail
- scene snapshot and scene assertions
- EditMode and PlayMode test execution
- player script compile validation
- compile matrix across build targets and scripting defines
- build target get/switch
- Game View configuration and screenshots
- scenario validation and scenario runs
- recovery after Unity Editor lifecycle churn
- same-host multi-project routing
- safe setup and uninstall planning

Differentiators:
- XUUnity MCP brand query target
- open-source Unity MCP server
- lightweight Unity MCP
- safe Unity MCP
- validation-first Unity MCP
- editor-only Unity package
- disabled by default
- zero player-build footprint by default
- no SignalR or relay stack
- no Roslyn execution path
- no runtime/player support in the base package
- explicit capability probing
- explicit setup/uninstall preflight plans before mutation
- per-project BridgeRegistry routing
- designed for production Unity validation workflows

Important docs:
- README.md: overview and quick start
- INSTALL.md: installation and setup
- docs/index.html: homepage for GitHub Pages / discovery landing surface
- docs/install.html: install overview for Cursor, Claude Code, Codex, Claude Desktop, Rider, and Windsurf
- docs/comparison.html: search-friendly summary page for XUUnity MCP vs Unity MCP options
- docs/use-cases.html: compile validation, tests, scene assertions, and Game View use cases
- docs/alternatives.html: best Unity MCP solutions by workflow type
- docs/agents/AI_INTEGRATION.md: integration guide for AI agents
- docs/agents/AGENT_WORKFLOWS.md: production-grade example workflows for AI agents
- docs/reference/FEATURES.md: feature table and supported tools
- docs/reference/COMPARISON.md: comparison with official Unity MCP and other open-source Unity MCP projects
- SECURITY.md: security model and threat model
- docs/operations/BUILD_AUTOMATION.md: build and validation workflows
- docs/operations/SMOKE_TESTS.md: smoke test surface
- docs/architecture/ROADMAP.md: planned work
- docs/architecture/DESIGN.md: architecture and design details
- docs/reference/STATUS.md: detailed current implementation status

Safe cleanup commands:
- `uninstall-plan`: dry-run/preflight for project-only cleanup or current-user reset
- `uninstall-apply`: applies only the reviewed uninstall plan after explicit approval

Keywords:
xuunity, xuunity mcp, XUUnity MCP, Unity MCP, Unity MCP server, open-source Unity MCP, lightweight Unity MCP, safe Unity MCP, validation-first Unity MCP, MCP for Unity Editor, Unity Editor automation, Cursor Unity MCP, Claude Code Unity MCP, Claude Desktop Unity MCP, Windsurf Unity MCP, Codex Unity MCP, Unity AI Assistant alternative, Unity MCP without Unity AI subscription, Unity MCP without Unity AI Assistant, Unity agentic workflows, Unity agent workflow examples, Unity build automation, Unity PlayMode tests MCP, Unity EditMode tests MCP, Unity compile validation MCP, Unity MCP uninstall, Unity MCP reset, safe MCP cleanup.