DOCKER_DEPLOYMENT.md

The Unity-MCP Server is available as a lightweight Docker container, ideal for cloud deployments or isolating the AI server environment. GitHub repository: IvanMurzak/Unity-MCP

• Image: ivanmurzakdev/unity-mcp-server
• Tags: latest, X.Y.Z (e.g., 0.50.1)
• Architectures: linux/amd64, linux/arm64 (Apple Silicon compatible)

🚀 Quick Start

Run the server on port 8080:

docker run -p 8080:8080 ivanmurzakdev/unity-mcp-server:latest

⚠️ Required:

1. Install Unity Editor
2. Install AI Game Developer plugin in Unity project.

⚙️ Configuration

The server can be configured using environment variables.

Variable	Default	Description
MCP_PLUGIN_PORT	8080	The port the server listens on for both Client (HTTP) and Plugin (SignalR) connections.
MCP_PLUGIN_CLIENT_TRANSPORT	streamableHttp	Transport for the Client connection: streamableHttp or stdio.
MCP_PLUGIN_CLIENT_TIMEOUT	10000	Timeout in milliseconds for Plugin responses.
MCP_AUTHORIZATION	none	Authentication mode for incoming Client connections: none or required.
MCP_PLUGIN_TOKEN	(unset)	Bearer token is optional. If set - server accept only connection with this exact token. Works only with MCP_AUTHORIZATION=required.

Example: Custom Port

Run on port 9090:

docker run \
  -e MCP_PLUGIN_PORT=9090 \
  -p 9090:9090 \
  ivanmurzakdev/unity-mcp-server:latest

Example: STDIO Mode

STDIO mode is used when the MCP Client manages the Docker process directly.

docker run -i \
  -e MCP_PLUGIN_CLIENT_TRANSPORT=stdio \
  -p 8080:8080 \
  ivanmurzakdev/unity-mcp-server:latest

Example: Bearer Token Authentication

Require a bearer token from the MCP Client:

docker run \
  -e MCP_AUTHORIZATION=required \
  -e MCP_PLUGIN_TOKEN=your-secret-token \
  -p 8080:8080 \
  ivanmurzakdev/unity-mcp-server:latest

💻 Client Configuration

To use the Dockerized server with your AI Client (e.g., Claude):

HTTP Mode (Recommended for Remote/Cloud)

{
  "mcpServers": {
    "ai-game-developer": {
      "url": "http://localhost:8080"
    }
  }
}

With bearer token authentication (MCP_AUTHORIZATION=required):

{
  "mcpServers": {
    "ai-game-developer": {
      "url": "http://localhost:8080",
      "headers": {
        "Authorization": "Bearer your-secret-token"
      }
    }
  }
}

STDIO Mode (Managed by Client)

{
  "mcpServers": {
    "ai-game-developer": {
      "command": "docker",
      "args": [
        "run",
        "-t",
        "--rm",
        "-e", "MCP_PLUGIN_CLIENT_TRANSPORT=stdio",
        "-p", "8080:8080",
        "ivanmurzakdev/unity-mcp-server:latest"
      ]
    }
  }
}

With bearer token authentication (MCP_AUTHORIZATION=required):

{
  "mcpServers": {
    "ai-game-developer": {
      "command": "docker",
      "args": [
        "run",
        "-t",
        "--rm",
        "-e", "MCP_PLUGIN_CLIENT_TRANSPORT=stdio",
        "-e", "MCP_AUTHORIZATION=required",
        "-e", "MCP_PLUGIN_TOKEN=your-secret-token",
        "-p", "8080:8080",
        "ivanmurzakdev/unity-mcp-server:latest"
      ]
    }
  }
}