搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

phone-harness/mcp

AI 工程

这是一个托管 MCP 服务,让 AI 智能体在云端操控真实 iPhone 和 Android 模拟器。

812
71
Python
MIT
创建于 26 天前

项目介绍

Phone Harness 提供一个托管的 Model Context Protocol(MCP)服务,让 AI 智能体获得一台可操作的云 iPhone 或 Android 模拟器。使用方不需要 Mac、adb 或设备配对,只要在 MCP 客户端里添加远程 streamable HTTP 地址并完成 OAuth 登录(或使用 API Key),智能体就能列出设备、启动手机、截图、识别屏幕文字、点击、滑动、输入、按键和启动应用。

仓库本身是 MCP 服务端实现(Python,MIT 协议),真实手机运行在云端托管端点后面,适合希望让智能体完成移动端操作、又不想维护本地设备环境的开发者和团队。

托管服务注册的工具包括 phone_list_available_devices、phone_start_device、phone_take_screenshot、phone_list_elements_on_screen、phone_click_on_screen_at_coordinates、phone_swipe_on_screen、phone_type_keys 等,工具命名沿用 mobile-mcp。

快速使用

  1. 打开所用 MCP 客户端的远程服务器设置。Claude 可进入 Customize → Connectors → Add custom connector(或直接使用 Add to Claude 按钮);Cursor 则在 ~/.cursor/mcp.json 或 .cursor/mcp.json 中添加:
{
  "mcpServers": {
    "phone-harness": {
      "url": "https://mcp.phone-harness.com/mcp"
    }
  }
}
  1. 使用端点 https://mcp.phone-harness.com/mcp 完成 OAuth 登录,授权范围包含 phone:drive。如果不想走 OAuth,可改为在请求头中发送 Authorization: Bearer pck_…。

  2. 在智能体会话中调用 phone_start_device(不指定设备时会启动临时 Android 模拟器),然后用其他工具操作屏幕和应用;结束时调用 phone_stop_device。

如果想自行部署服务端,README 指向 self-hosting 指南,其中覆盖本地 stdio、Docker 和 Vercel 部署方式。

使用约束

  • 托管服务不是免费的:Android 模拟器在免费启动后按手机分钟计费,云 iPhone 按月订阅,具体价格见 pricing 页面。
  • phone_start_device 的 minutes 参数控制会话时长(默认 30),不是计费单位。会话停止后手机上未保存的内容会丢失;停止云 Android 会结束按分钟计费。
  • 没有直接打开 URL 的工具,智能体只能通过启动应用并手动导航来完成任务。phone_save_screenshot 只由本地 stdio 服务注册,托管服务不提供。
  • iPhone 操控需要账号持有 iPhone 订阅;在 ChatGPT 网页端,驱动手机的自定义 MCP 服务仅限 Business、Enterprise 和 Edu 工作区使用。

HotRepo 点评

该项目没有记录到 HotRepo 的 GitHub 日榜名次、榜单快照或 Hacker News 讨论,因此没有可报告的热度趋势数据。从现有材料看,它有一套清晰的 MCP 工具接口、一个统一的托管地址,以及覆盖 Claude、Cursor、Claude Code、Codex、VS Code、Gemini CLI 等大量客户端的接入说明。实际使用的主要取舍是:核心能力依赖付费云手机服务,而服务端代码以 MIT 协议开源,可以自行部署。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. hridaya423/phonedriver让 AI 代理通过 MCP 和命令行读取并操控 Android 手机与 iPhone 屏幕,付款类操作前先向人确认。Rust150
  2. JosssphZhou/poki让 Claude Code、Codex 等 MCP 客户端通过 Mac 操控真实 iPhone,无需越狱或额外硬件。JavaScript109
  3. droidrun/mobilerun用自然语言驱动真实 Android 和 iOS 设备的 LLM 无关框架,可通过 CLI 或 Python API 完成点击、滑动、输入和多步任务。Python10,059
  4. ZSeven-W/dsh-android把 Android 模拟器或 USB 手机实时串流进对话,并通过 adb 驱动它完成构建、安装与 UI 操作。TypeScript355
  5. ZSeven-W/dsh-ios为编程 Agent 提供 22 个工具,在会话内启动、构建并操控 iOS 模拟器或 USB 真机,带可点拖的实时侧栏。TypeScript469