Phonebox

dev.phoneboxv0.1.0更新于 Oct 8, 2026

Cloud Android phones for AI agents: create a phone, read the screen, tap, type, install APKs, park.

已验证Streamable HTTP可网页运行Developer ToolsBrowser Automation

概览

AI 生成的概览

为 AI 助手提供托管的云端 Android 手机，可查看屏幕、点击、输入、安装 APK，并在闲置时停放。

功能
Phonebox 是一个托管的 Android MCP 服务器，为智能体提供一台真实的云端手机。工具包括 create_phone、observe（以带编号的文本列表加截图读取屏幕）、act（按顺序执行最多 20 个操作，如点击、输入、滑动、滚动、打开应用、等待元素）、install_app、APK 上传辅助工具、用于人工接管的 live_view_url，以及 start_phone、park_phone、list_phones、get_phone、list_apps、reboot_phone 等生命周期管理工具。无需 ADB、Android Studio 或模拟器。
适用场景
当智能体需要操作真实 Android 设备时使用：测试刚构建的 APK、探索应用并用准确的屏幕文本报告缺陷，或在 CI、沙箱和远程开发机上自动化移动端流程。仅支持 Android，不支持 iOS，也没有电话号码、短信或通话功能。
运行要求
远程 Streamable HTTP 端点 Authorization 请求头中携带 Bearer 形式的 Phonebox API 密钥（pbx_...）。无需本地运行时、软件包或 OAuth。密钥可在控制台创建，也可让智能体从终端完成注册获取；提供含额度的免费方案。
安装前请注意
Authorization 请求头携带密钥，请勿写入共享配置或粘贴到聊天中。按每手机分钟 0.06 美元计费，按秒计费、最低一分钟，停放的手机会停止计费但运行中的会产生费用。智能体可以安装应用、输入、点击并改变手机状态，实时查看链接还允许他人观看和操作该手机。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Phonebox，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "phonebox": {
      "type": "http",
      "url": "https://phonebox.dev/mcp"
    }
  }
}

README

Phonebox Android MCP server

A hosted Android MCP server for Claude Code, Codex, Cursor and any MCP client, from Phonebox, the agent-first cloud phone. Your agent gets a real Android phone in the cloud. It can read the screen, tap, type, install your APK, hand off to a human, and park the phone when it's done. You don't need ADB, Android Studio or an emulator.

bash
claude mcp add --transport http phonebox https://phonebox.dev/mcp \  --header "Authorization: Bearer $PHONEBOX_API_KEY"
  • Endpoint: https://phonebox.dev/mcp (Streamable HTTP, bearer API key)
  • Price: $0.06 per phone-minute, billed per second, 1-minute minimum. Parked phones are free and keep their apps and sign-ins.
  • Start free: $2 of credit, no card → phonebox.dev

This repo holds the configs and examples. The server itself is hosted by Phonebox, so there's nothing to run.

Why agent-first

Most cloud phones were built for social-media dashboards or QA test suites and added an API later. Phonebox was built for the agent: your agent signs you up from the terminal, reads the screen as text, gets errors with a next step, and never has a write retried behind its back. Idle phones park themselves for free.

Why hosted instead of an ADB MCP server?

Local ADB MCP serverPhonebox hosted MCP
Where the phone runsAn emulator or USB phone on your machinePhonebox's cloud
SetupAndroid SDK, ADB, a system imageOne URL and an API key
Works from CI, sandboxes and remote dev boxesOnly with nested virtualization or a deviceYes
State between sessionsWhatever your emulator keepsApps, files and sign-ins kept while parked
Human handoffSomeone at the machineA live view link in any browser

Get an API key

The fastest way is to paste this into your coding agent. It signs you up from the terminal, and you never paste a key into the chat:

text
Read https://phonebox.dev/setup.md and set me up with Phonebox from here: get me signed in and ready, then find out what I want to use phones for and help me with that.

Or create a key in the console and export PHONEBOX_API_KEY=pbx_….

Connect your client

Claude Code — run the command at the top, or commit this repo's .mcp.json. It reads the key from each person's environment:

json
{  "mcpServers": {    "phonebox": {      "type": "http",      "url": "https://phonebox.dev/mcp",      "headers": { "Authorization": "Bearer ${PHONEBOX_API_KEY}" }    }  }}

Cursor: add examples/cursor-mcp.json to ~/.cursor/mcp.json or .cursor/mcp.json.

Codex: add examples/codex-config.toml to ~/.codex/config.toml.

Any other client: point it at https://phonebox.dev/mcp with an Authorization: Bearer pbx_… header. The server is stateless Streamable HTTP and doesn't use OAuth.

Tools

ToolWhat it does
create_phoneCreates a cloud Android phone and waits until it's ready
observeReads the screen as a numbered text list, plus a 720px screenshot
actRuns up to 20 actions in order: tap, type, swipe, scroll, open an app, wait for an element
install_appInstalls from the app library or from your own uploaded APK
create_app_upload / complete_app_uploadUploads your APK with one curl command
live_view_urlA link for a person to watch and control the phone
start_phone / park_phoneResumes a parked phone, or parks it to stop billing
list_phones / get_phone / list_apps / reboot_phoneFind phones, wait for them, list apps, restart a stuck phone

What the agent reads from observe:

text
app com.android.launcher3screen 1080x2400[1] EditText "Search apps" #search clickable editable (540,250)[2] TextView "Chrome" #icon clickable (200,1900)[3] TextView "Settings" #icon clickable (500,1900)

Examples

What it isn't

Android only (no iOS), and there are no phone numbers, SMS or calls. Phonebox gives your agent the device, not telephony.

Learn more

来源：README.md，提交 742ab26

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.1.0最新Oct 8, 2026