ivanmurzakdev/unity-mcp-server

Unity-MCP Server Docker镜像

镜像概述

Unity-MCP Server作为轻量级Docker容器提供，适用于云部署或隔离AI服务器环境。它与Unity插件协同工作，基于Model Context Protocol（MCP），支持linux/amd64和linux/arm64（兼容Apple Silicon）架构，标签包括latest和版本号（如0.50.1）。

核心功能

• 与Unity Editor插件实现MCP协议通信
• 支持HTTP和STDIO两种客户端传输方式
• 可配置端口、超时时间及Bearer token认证
• 兼容多架构，适配本地开发与云部署场景

使用场景

• 本地Unity项目集成MCP功能
• 云服务器部署MCP服务器支持远程访问
• 隔离AI服务器环境提升安全性

配置说明

快速启动

在8080端口运行服务器：

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

⚠️ 前置要求：

1. 安装Unity Editor
2. 在Unity项目中安装https://github.com/IvanMurzak/Unity-MCP%E6%8F%92%E4%BB%B6

环境变量配置

服务器支持通过环境变量调整参数，常用变量如下：

示例：自定义端口

在9090端口运行：

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

示例：STDIO模式

客户端直接管理Docker进程时使用：

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

示例：Bearer Token认证

要求客户端提供认证token：

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

客户端配置

将Docker服务器与AI客户端（如Claude）配合时，需配置客户端：

HTTP模式（推荐远程/云部署）

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

带Bearer token认证：

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

STDIO模式（客户端管理）

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

带Bearer token认证：

json
{
  "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"
      ]
    }
  }
}