Unity Build Automation MCP
Provides tools for managing Unity Cloud Build projects, build targets, builds, and logs, enabling starting and canceling builds.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Unity Build Automation MCP show me the build status for my project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Unity Build Automation MCP Server
Unity Cloud Build (Build Automation) の REST API を MCP (Model Context Protocol) サーバーとしてラップし、Claude Code から直接ビルド状況の確認・操作を可能にします。
Architecture
Claude Code <--stdio--> MCP Server (Node.js/TypeScript) <--HTTPS--> Unity Build API
https://build-api.cloud.unity3d.com/api/v1/Related MCP server: UniMCP4CC
Setup
Prerequisites
Node.js (ES2022+)
Unity Build Automation API Key
Install
# npx で直接使う場合(インストール不要)
npx -y unity-build-automation-mcp
# グローバルインストール
npm install -g .
# ローカル開発
npm installEnvironment Variables
Variable | Required | Description |
| Yes | Unity Build Automation API Key |
| Yes | Organization ID |
| No | Default project name or ID |
Claude Code MCP Settings
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>"
}
}
}
}Tools
Read Operations
Tool | Description |
| Organization 内のプロジェクト一覧を取得 |
| プロジェクトのビルドターゲット一覧を取得 |
| ビルド一覧を取得(ステータスでフィルタ可) |
| 特定ビルドの詳細情報を取得 |
| ビルドログの末尾N行を取得 |
Write Operations
Tool | Description |
| 新しいビルドを開始 |
| 実行中のビルドをキャンセル |
Write operations は Claude Code 側で実行前に確認プロンプトが表示されます。
Usage Examples
ビルド状況の確認:
「最新のビルド状況を見せて」
失敗ビルドの調査:
「失敗したビルドのログを確認して」
ビルドの開始:
「Android の develop ブランチでビルドを開始して」
ビルドターゲットの確認:
「MyProject のビルドターゲット一覧を見せて」
Parameters
ほとんどのツールで project パラメータは省略可能です。省略時はデフォルトプロジェクトが使用されます。プロジェクト名(例: MyProject)または UUID のどちらでも指定できます。
Build Status Values
Status | Description |
| キュー待ち |
| ビルダーに送信済み |
| ビルド中 |
| 再開 |
| 成功 |
| 失敗 |
| キャンセル |
| 不明 |
Development
npm run dev # TypeScript watch mode
npm run build # Build
npm start # Run serverProject Structure
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.tsLicense
Private
Available Tools
7 toolscancel_buildCancel BuildC
Cancel a running build. This is a write operation.
Inputs: buildtarget (required), build_number (required), project.
get_buildGet Build DetailsCRead-only
Get detailed information about a specific build.
Inputs: buildtarget (required), build_number (required), project.
get_build_logGet Build LogARead-only
Get the build log for a specific build. Returns the last N lines to help investigate failures.
Inputs: buildtarget (required), build_number (required), tail, project.
list_buildsList BuildsBRead-only
List builds for a project. Can filter by build target and status.
Inputs: status, project, per_page, buildtarget.
list_build_targetsList Build TargetsARead-only
List build targets for a project. Defaults to the configured default project.
Inputs: project.
list_projectsList ProjectsARead-only
List all projects in the Unity Build Automation organization.
Inputs: no named parameters.
start_buildStart BuildC
Start a new build for a build target. This is a write operation.
Inputs: buildtarget (required), clean, branch, project.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct resource and action: listing projects, build targets, or builds; getting build details or logs; and starting or canceling builds. The descriptions clearly differentiate similar-sounding operations like list_build_targets and list_builds.
All tool names follow a consistent snake_case verb_noun pattern (list_, get_, start_, cancel_), with only natural extensions like list_build_targets and get_build_log. No mixed conventions or vague verbs are present.
Seven tools are well-scoped for a build automation server, covering core listing, inspection, and control operations without redundancy. The count sits comfortably within the ideal 3–15 range.
The surface covers the essential build lifecycle: listing projects, targets, and builds; retrieving build details and logs; and starting or canceling builds. Minor gaps exist, such as no tool to inspect or manage build target configurations directly, but core workflows are fully supported.
Maintenance
Related MCP Connectors
Trigger and inspect Codemagic CI builds, apps and artifacts.
Build, validate, test-run and publish AIOS workflows from Claude Code, Codex, Cursor or VS Code.
Run UX research from Claude — create card sort studies, list studies, pull headline stats.
Create projects, nodes, and tasks in UluP Spaces by conversation with Claude.
Related MCP Servers
- AlicenseAqualityCmaintenanceA Model Context Protocol server that enables Claude to interact directly with Unity projects, providing tools for script creation, asset management, and project building.15246 npm10MIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude Code to directly control Unity Editor, supporting scene manipulation, component operations, asset management, prefab handling, and audio control through natural language commands.5MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants like Claude to interact with Unity projects programmatically, supporting project management, asset creation, and build automation.1MIT
- AlicenseBqualityDmaintenanceEnables Claude to control Unity Hub and Editor headlessly, allowing automated game building, asset generation, and PBR texture creation.941MIT