msanatan/mcp-for-unity-server repository overview

⁠MCP for Unity Server (Docker Image)

Model Context Protocol server for Unity Editor integration. Control Unity through natural language using AI assistants like Claude, Cursor, and more.

Maintained by Coplay⁠ - This project is not affiliated with Unity Technologies.

💬 Join our community: Discord Server⁠

Required: Install the Unity MCP Plugin⁠ to connect Unity Editor with this MCP server.

⁠Quick Start

⁠1. Pull the image

docker pull msanatan/mcp-for-unity-server:latest

⁠2. Run the server

docker run -p 8080:8080 msanatan/mcp-for-unity-server:latest

This starts the MCP server on port 8080.

⁠3. Configure your MCP Client

Add the following configuration to your MCP client (e.g., Claude Desktop config, Cursor settings):

{
  "mcpServers": {
    "UnityMCP": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

⁠Configuration

The server connects to Unity Editor automatically when both are running. No additional configuration needed.

Environment Variables:

• DISABLE_TELEMETRY=true - Opt out of anonymous usage analytics
• LOG_LEVEL=DEBUG - Enable detailed logging (default: INFO)

Example running with environment variables:

docker run -p 8080:8080 -e LOG_LEVEL=DEBUG msanatan/mcp-for-unity-server:latest

⁠Example Prompts

Once connected, try these commands in your AI assistant:

• "Create a 3D player controller with WASD movement"
• "Add a rotating cube to the scene with a red material"
• "Create a simple platformer level with obstacles"
• "Generate a shader that creates a holographic effect"
• "List all GameObjects in the current scene"

⁠Documentation

For complete documentation, troubleshooting, and advanced usage, please visit the GitHub repository:

📖 Full Documentation⁠

⁠License

MIT License - See LICENSE⁠