Sign inSign up

ivanmurzakdev/unity-mcp-server

By ivanmurzakdev

•Updated 3 months ago

MCP Server for Unity Editor, works in pair with Unity Plugin. MCP is Model Context Protocol.

Image
Machine learning & AI
Developer tools
2

10K+

ivanmurzakdev/unity-mcp-server repository overview

AI Game Developer — Unity MCP

MCP OpenUPM Docker Image Unity Editor Unity Runtime r
Discord OpenUPM Stars License Stand With Ukraine

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)

Docker Launch

AI Game Developer — Unity MCP

⁠🚀 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.

AI Game Developer — Unity MCP

⁠⚙️ Configuration

The server can be configured using environment variables.

VariableDefaultDescription
MCP_PLUGIN_PORT8080The port the server listens on for both Client (HTTP) and Plugin (SignalR) connections.
MCP_PLUGIN_CLIENT_TRANSPORTstreamableHttpTransport for the Client connection: streamableHttp or stdio.
MCP_PLUGIN_CLIENT_TIMEOUT10000Timeout in milliseconds for Plugin responses.
MCP_AUTHORIZATIONnoneAuthentication 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

AI Game Developer — Unity MCP

⁠💻 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"
      ]
    }
  }
}

AI Game Developer — Unity MCP

Tag summary

Content type

Image

Digest

sha256:4070b7969…

Size

91.4 MB

Last updated

3 months ago

docker pull ivanmurzakdev/unity-mcp-server