AI导哈

Unity构建自动化MCP服务

Unity构建自动化的REST API包装为MCP服务器，允许通过Claude Code直接查看和操作构建状态。

  • by akiraKido
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 akiraKido/Unity-Build-Automation-MCP

使用说明

Unity构建自动化MCP服务器

将“Unity Cloud Build”的REST API MCP（模型上下文协议） 以服务器的形式包装，可以直接从Claude Code中确认和操作构建状况。

建筑

Claude Code <--stdio--> MCP Server (Node.js/TypeScript) <--HTTPS--> Unity Build API
                                                                     https://build-api.cloud.unity3d.com/api/v1/

设置

先决条件

  • Node.js（ES2022+）
  • Unity Build Automation API密钥

安装

# npx で直接使う場合（インストール不要）
npx -y unity-build-automation-mcp

# グローバルインストール
npm install -g .

# ローカル開発
npm install

环境变量

变量 必填 描述
UNITY_BUILD_API_KEY 是 Unity Build Automation API密钥
UNITY_BUILD_ORG_ID 是 组织ID
UNITY_BUILD_DEFAULT_PROJECT 否 默认项目名称或ID

克劳德代码MCP设置

在Claude Code CLI中添加：

claude mcp add unity-build -- npx -y unity-build-automation-mcp

或 ~/.claude.json / .mcp.json 手动添加到：

{
  "mcpServers": {
    "unity-build": {
      "command": "npx",
      "args": ["-y", "unity-build-automation-mcp"],
      "env": {
        "UNITY_BUILD_API_KEY": "<your-api-key>",
        "UNITY_BUILD_ORG_ID": "<your-org-id>"
      }
    }
  }
}

直接从本地存储库使用：

{
  "mcpServers": {
    "unity-build": {
      "command": "node",
      "args": ["<path-to-repo>/dist/index.js"],
      "env": {
        "UNITY_BUILD_API_KEY": "<your-api-key>",
        "UNITY_BUILD_ORG_ID": "<your-org-id>"
      }
    }
  }
}

工具

读取操作

工具 说明
list_projects 获取Organization中的项目列表
list_build_targets 获取项目的构建目标列表
list_builds 获取构建列表（可按状态过滤）
get_build 获取特定构建的详细信息
get_build_log 获取构建日志的末尾N行

写入操作

工具 说明
start_build 开始新的构建
cancel_build ｜取消正在运行的构建｜

在Claude Code侧运行Write operations之前，会显示确认提示。

用法示例

检查构建状态：

“让我看看最新的构建情况。”

调查失败构建：

“检查失败的构建日志”

开始构建：

“在Android的develop分支中启动构建”

确认构建目标：

“我的项目构建目标列表”

参数

大多数工具 project 参数是可选的。省略时使用默认项目。项目名称（例如： MyProject）或UUID。

构建状态值

状态 描述
queued 等待队列
sentToBuilder 已发送到生成器
started 正在构建
restarted 再开
success 成功
failure 失败
canceled 取消
unknown 不明

发展

npm run dev    # TypeScript watch mode
npm run build  # Build
npm start      # Run server

项目结构

src/
  index.ts             # Entry point, MCP server setup
  api.ts               # Unity Build API client
  config.ts            # Configuration / env var handling
  types.ts             # TypeScript type definitions
  format.ts            # Output formatting utilities
  tools/
    list-projects.ts
    list-build-targets.ts
    list-builds.ts
    get-build.ts
    get-build-log.ts
    start-build.ts
    cancel-build.ts

许可证

私人

相关 MCP