macbox

macbox

コーディングエージェントのための、本物の Mac です。 macbox を使うと、Claude Code、Codex、Cursor、または任意の MCP クライアントが、Linux マシンやクラウドエージェントのサンドボックスを含むあらゆるマシンから、クラウド上の本物の Mac でネイティブ iOS アプリをビルド、テスト、実行し、操作できます。

• ビルドとテスト： 最新の Xcode を搭載した Mac mini で、xcodebuild と XCTest、UI テストを実行できます。エージェントは結果とエラー行を受け取ります。
• アプリの実行と操作： iOS シミュレーターでアプリを起動し、画面の内容を読み取り、タップ、入力、スワイプできます。エージェントは自分の作業を確認できます。
• ライブで確認： 実行中のアプリごとにブラウザーリンクが発行され、そこからアプリを見たり操作したりできます。

Mac の利用料金は 1 分あたり $0.05 で、分単位の課金です。1 分未満のジョブは無料です。macbox.build でアクセス権と無料クレジットを取得できます。

セットアップ

最も手早い方法は、エージェントに次のように伝えることです。

https://api.macbox.build/guide/ に従って macbox をセットアップしてください

または、クライアントを選択してください。

Claude Code（プラグイン：スキル + MCP ツール）

claude plugin marketplace add opslane/macbox-agent
claude plugin install macbox@macbox

任意の MCP クライアント（Codex、Cursor、Claude Desktop、VS Code など）、Node 18 以降：

{
  "mcpServers": {
    "macbox": { "command": "npx", "args": ["-y", "macbox", "mcp"] }
  }
}

CLI（macOS または Linux）：

curl -fsSL https://api.macbox.build/install.sh | sh
macbox login
macbox setup      # installs the skill for Claude Code and Codex, and notes in CLAUDE.md / AGENTS.md

スキルのみ（Claude Code、Codex、Cursor、Gemini CLI、OpenCode、その他 多数）：

npx skills add opslane/macbox-agent

CLI がまだセットアップされていない場合、スキルがエージェントにガイドを案内し、インストールを促します。

macbox login でログインするか、MACBOX_API_KEY を設定してください（クラウドエージェントでは、環境シークレットとして設定します）。

エージェントが利用できる機能

MCP ツール	CLI	機能
build	macbox build	iOS シミュレーター向けにビルドします（Mac アプリの場合は macOS 向け）
test	macbox test	新しいシミュレーターでテストを実行します。テストごとに PASS/FAIL の行が 1 つ表示されます
screenshot	macbox screenshot	最後のビルドを起動し、画像を返します
run	macbox run	アプリを起動したままにし、ライブリンクを返します
describe、tap、type、swipe、press_button、look	macbox ui ...	人が使うように実行中のアプリを操作します
stop	macbox stop	実行中のアプリを終了します
report_problem	macbox feedback	macbox 側で問題が発生したとき、macbox チームに知らせます

より高度な作業には、macbox mcp --xcode もあります。Sentry のオープンソース MobileBuildMCP Xcode ツール（LLDB デバッグ、Swift パッケージ、 シミュレーター設定）を macbox の Mac 上で実行します。

仕組み

macbox は、Git が追跡するファイルを 1 台の Mac mini に送信します（指定しない限り、.env ファイルは送信しません）。送信先は、あなただけが使用し、他の VM や当社のネットワークに接続できない専用の macOS VM です。初回以降は変更されたファイルのみを送信し、ビルドキャッシュも保持するため、2 回目のビルドは高速です。現在、ネイティブ iOS アプリに対応しています：Xcode プロジェクトとワークスペース、Swift パッケージ、CocoaPods、XcodeGen。未対応：署名、TestFlight、React Native、Flutter。

詳細ガイド：https://api.macbox.build/guide/ · ご質問：Discord

このリポジトリについて

macbox のオープンソース部分：Claude Code プラグイン（.claude-plugin/、skills/、.mcp.json）、 macbox npm パッケージ（npm/。api.macbox.build から CLI をダウンロードし、公開済みの SHA256SUMS と照合します）、および MCP Registry エントリー（server.json）。macbox サービス自体は、当社の Mac 上で稼働しています。

MIT ライセンスです。