macbox

本地服务

macbox.build开发工具01 天前更新

代码仓库访问官网

关于 macbox

macbox 为编码 Agent 和 MCP 客户端提供云端 Mac，用于构建、测试并操作模拟器中的原生 iOS 应用。它返回构建和测试结果，并为运行中的应用提供浏览器链接。

主要功能

01使用 xcodebuild 构建应用
02运行 XCTest 和 UI 测试
03在 iOS 模拟器中启动应用
04查看屏幕并执行点击、输入或滑动
05通过浏览器链接观看运行中的应用

适用场景

01在非 Mac 设备上构建 iOS 应用
02运行测试并检查结果
03通过模拟器交互检查应用行为

MCP 相关

macbox 向 MCP 客户端提供构建、测试、截图、运行和模拟器交互工具，并在云端 Mac 上执行任务。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "opslane-macbox": {
      "command": "npx",
      "args": [
        "-y",
        "macbox"
      ],
      "env": {
        "MACBOX_API_KEY": "<MACBOX_API_KEY>"
      }
    }
  }
}

启动命令npx -y macbox

需要配置的环境变量

MACBOX_API_KEY密钥Your macbox API key (mbx_...). Optional if you ran `macbox login`.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmacbox0.6.2stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

macbox

为你的编码 Agent 提供一台真正的 Mac。 macbox 让 Claude Code、Codex、Cursor 或任何 MCP 客户端都能在云端的真实 Mac 上构建、测试、运行原生 iOS 应用并进行交互，无论你使用的是哪台机器，包括 Linux 设备和云端 Agent 沙盒。

**构建和测试：**在运行最新 Xcode 的 Mac mini 上使用 xcodebuild、XCTest 和 UI 测试。你的 Agent 会收到结果和错误行。
**运行并操作应用：**在 iOS 模拟器上启动应用，读取屏幕内容、点击、输入和滑动，让你的 Agent 检查自己的工作。
**实时查看：**每个正在运行的应用都有一个浏览器链接，你也可以通过它查看和操作应用。

按 Mac 使用分钟计费，每分钟计费一次：$0.05，不足一分钟的任务免费。前往 macbox.build 获取访问权限和免费额度。

设置

最快的方法：告诉你的 Agent

按照 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"] }
  }
}

命令行工具（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

如果尚未设置命令行工具，技能会引导你的 Agent 前往指南进行安装。

使用 macbox login 登录，或设置 MACBOX_API_KEY（在云端 Agent 中将其设为环境密钥）。

你的 Agent 可使用的功能

MCP 工具	命令行工具	功能
`build`	`macbox build`	为 iOS 模拟器构建（Mac 应用则为 macOS 构建）
`test`	`macbox test`	在全新模拟器上运行测试；每项测试返回一行 PASS/FAIL
`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 跟踪的文件（除非你明确要求，否则不会发送 .env 文件）发送到一台 Mac mini，并放入专属于你的 macOS 虚拟机中。该虚拟机无法访问其他虚拟机或我们的网络。首次之后只会发送已更改的文件，构建缓存也会保留，因此第二次构建速度很快。当前支持原生 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 下载命令行工具，并根据已发布的 SHA256SUMS 校验），以及 MCP Registry 条目（server.json）。macbox 服务本身运行在我们的 Mac 上。

采用 MIT 许可证。

支持 Markdown

登录后评论