Configuration

Configuration

If the automatic configuration doesn't work, or you need advanced setups (like remote servers), you can configure Unity-MCP manually.

Plugin Configuration (Unity)

In the Window -> AI Game Developer dashboard, you can set:

• Port: The port the server listens on (Default: 8080).
• Transport: HTTP (Recommended) or stdio.

Client Configuration (JSON)

Add the following to your MCP Client's configuration file (e.g., claude_desktop_config.json):

Windows

{
  "mcpServers": {
    "Unity-MCP": {
      "command": "C:/Path/To/Your/Project/Library/mcp-server/win-x64/unity-mcp-server.exe",
      "args": [
        "--port=8080",
        "--client-transport=stdio"
      ]
    }
  }
}

macOS (Intel)

{
  "mcpServers": {
    "Unity-MCP": {
      "command": "/Path/To/Your/Project/Library/mcp-server/osx-x64/unity-mcp-server",
      "args": [
        "--port=8080",
        "--client-transport=stdio"
      ]
    }
  }
}

macOS (Apple Silicon / M1 / M2)

{
  "mcpServers": {
    "Unity-MCP": {
      "command": "/Path/To/Your/Project/Library/mcp-server/osx-arm64/unity-mcp-server",
      "args": [
        "--port=8080",
        "--client-transport=stdio"
      ]
    }
  }
}

Note: Replace /Path/To/Your/Project/ with the actual absolute path to your Unity project.

---

Environment Variables & Arguments

The unity-mcp-server executable accepts the following arguments:

Argument	Env Variable	Default	Description
--port	UNITY_MCP_PORT	8080	Port for Unity Plugin connection.
--client-transport	UNITY_MCP_CLIENT_TRANSPORT	http	Transport for MCP Client (stdio or http).
--plugin-timeout	UNITY_MCP_PLUGIN_TIMEOUT	10000	Timeout (ms) for plugin response.

Docker Usage

If using Docker, start the container:

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

And configure your client to connect via HTTP SSE (if supported) or use the docker command in the client config:

"Unity-MCP": {
  "command": "docker",
  "args": ["run", "-i", "--rm", "-p", "8080:8080", "ivanmurzakdev/unity-mcp-server", "--client-transport=stdio"]
}