Mobilerun

MCP 服务

借助 Mobilerun MCP 服务，让 AI Agent 控制 Android 设备。
通过任意 MCP 客户端控制设备、运行 Agent 任务、管理应用，并在 Mobilerun Cloud 上构建工作流。

🔐 托管的 MCP 端点 — 使用 OAuth 登录，无需 API 密钥

https://cloud.mobilerun.ai/api/mcp

• 📱 列出、创建和管理 Android 设备
• 📸 检查屏幕截图和 UI 状态；点击、滑动和输入
• 🤖 运行 Agent 任务并与 Mobilerun 助手聊天
• 📦 管理应用、设备文件和设置
• 🔀 使用操作、触发器和 Webhook 构建工作流
• 🔑 使用 OAuth 登录 — 无需复制 API 密钥，也无需为托管端点安装任何内容
• 🛠️ 开源且可自托管

🚀 快速开始

连接到 https://cloud.mobilerun.ai/api/mcp。首次连接时，浏览器会打开并提示你使用 Mobilerun 账户登录（OAuth 2.1 + PKCE，搭配动态客户端注册）。无需 API 密钥。

Claude Code

claude mcp add --transport http mobilerun https://cloud.mobilerun.ai/api/mcp

在 Claude Code 中运行 /mcp 以登录。

Codex CLI

codex mcp add mobilerun --url https://cloud.mobilerun.ai/api/mcp
codex mcp login mobilerun

Cursor / VS Code

点击上方的安装徽章，并在出现提示时登录。手动配置 Cursor 时，请使用下方 其他 MCP 客户端 中的 mcpServers JSON。

{
  "servers": {
    "mobilerun": {
      "type": "http",
      "url": "https://cloud.mobilerun.ai/api/mcp"
    }
  }
}

Claude Desktop / claude.ai

使用此 URL 添加自定义连接器，然后登录：

https://cloud.mobilerun.ai/api/mcp

其他 MCP 客户端

使用客户端的设置添加远程 HTTP 服务。对于使用 mcpServers 的客户端（包括 Cursor）：

{
  "mcpServers": {
    "mobilerun": {
      "url": "https://cloud.mobilerun.ai/api/mcp"
    }
  }
}

💬 试试看

• “列出我的 Mobilerun 设备。”
• “在我的设备上打开设置并开启深色模式。”
• “为我的设备截屏，并描述屏幕上的内容。”
• “询问 Mobilerun 助手，我的哪些设备已就绪。”

🧰 工具

可用工具和操作取决于服务的策略和你的账户权限。

某些工具会创建计费资源（例如 create_device、购买代理，或助手为你执行的工作）。费用将计入已登录的账户。只有在用户明确确认后，才批准助手权限。

🔑 API 密钥（CI 和无头模式）

对于无法使用 OAuth 的客户端，请通过带有 Authorization: Bearer dr_sk_... 标头的 https://api.mobilerun.ai/v1/mcp 进行连接。在 Mobilerun Cloud 中创建密钥；请参阅 API keys。

{
  "mcpServers": {
    "mobilerun": {
      "url": "https://api.mobilerun.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer dr_sk_YOUR_KEY"
      }
    }
  }
}

claude mcp add --transport http mobilerun https://api.mobilerun.ai/v1/mcp --header "Authorization: Bearer dr_sk_YOUR_KEY"

🛠️ 可自托管与开发

packages/tools 包含与身份验证无关的工具核心；packages/server 提供 API 密钥 HTTP 和 stdio 传输方式。 运行 pnpm install && bun test 即可开始。 有关设置、配置、策略和操作详情，请参阅服务端参考。 路线图介绍了架构；工具契约涵盖兼容性和版本管理。

🤝 贡献

请参阅 CONTRIBUTING.md 以开始贡献。

🔒 安全

请通过 SECURITY.md 报告漏洞。

📄 许可证

本项目根据 Apache-2.0 许可证授权。