关于 thumbs
thumbs 让 Claude Code 和其他 MCP 客户端远程访问 iOS 模拟器,供 AI Agent 查看和操控。早期访问支持截图、带标签的点击目标及触控和文本操作;目前需通过候补名单加入。
主要功能
- 01查看手机截图和带标签的目标
- 02点击、输入、滑动和滚动
- 03打开应用和链接
- 04使用主屏幕按钮并处理提醒
适用场景
- 01检查网页在 iOS Safari 中的显示
- 02查看屏幕键盘对表单的影响
- 03自动操作内置应用中的导航
MCP 相关
远程 MCP 服务通过 Streamable HTTP 向 MCP 客户端提供手机截图和交互操作,并使用 OAuth 2.1 登录。早期访问使用共享的 iOS 模拟器。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.usethumbs.com/mcpclaude mcp add --transport http com-usethumbs-thumbs https://mcp.usethumbs.com/mcp{"mcpServers":{"com-usethumbs-thumbs":{"type":"http","url":"https://mcp.usethumbs.com/mcp"}}}在 Cursor 中打开{"servers":{"com-usethumbs-thumbs":{"type":"http","url":"https://mcp.usethumbs.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-usethumbs-thumbs":{"type":"http","url":"https://mcp.usethumbs.com/mcp"}}}{"mcpServers":{"com-usethumbs-thumbs":{"serverUrl":"https://mcp.usethumbs.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
thumbs:为你的 AI Agent 配备一部 iPhone(MCP)
thumbs 通过一个远程 MCP 服务 URL 和 Google 登录,让 Claude Code 或任何 MCP 客户端都能查看、点击和输入 iPhone。你无需在自己的设备上安装任何东西:不需要 Mac、Xcode 或线缆。
https://mcp.usethumbs.com/mcp
状态:早期访问,需加入候补名单。 免费早期访问使用 iOS Simulator(Safari 和 Apple 内置应用),由测试者共享,并一次只允许一人使用。未来计划支持你自己的真实 iPhone;目前尚不可用,也没有确定的日期或价格。
此仓库仅包含文档。服务端源代码未在此处发布。文档采用 MIT 许可证(见 LICENSE)。
Agent 能做什么
Agent 可以获取手机的屏幕截图,以及一份列出所有可点击项目的编号清单,其中包含标签和位置,因此它可以说“点击 4”,而不必猜测像素位置。它可以点击、输入、滑动、滚动、打开应用和链接、按下主屏幕按钮,以及响应系统提醒。
你可以用它做什么
- 在 iOS 上检查你的 Web 应用(早期访问期间可用):在 iPhone Simulator 的 Safari 中打开你的页面,查看手机上的显示效果,例如键盘遮住表单的情况。指南:如何用 AI Agent 在 iPhone 上测试 Web 应用。
- 测试你自己的应用、映射其他应用、使用没有 API 的应用(这些功能需要你自己的 iPhone,目前计划支持,但尚不可用)。
更多信息:如何通过 MCP 为 AI Agent 配备一部 iPhone。
连接
只有已从候补名单获准加入的账户才能使用手机。如果你还未加入,请加入候补名单。
| 客户端 | 方法 |
|---|---|
| Claude Code | 运行 claude mcp add --transport http thumbs https://mcp.usethumbs.com/mcp,然后运行 /mcp 并使用 Google 登录。在 Claude Code 等待期间,在同一台电脑上的浏览器中完成登录。 |
| Claude app | Settings › Connectors › Add custom connector,然后粘贴上方的 URL。 |
| Cursor | 在 Cursor 中安装,或将下方的通用配置添加到 ~/.cursor/mcp.json。 |
| VS Code | 在 VS Code 中安装,或将 { "servers": { "thumbs": { "type": "http", "url": "https://mcp.usethumbs.com/mcp" } } } 添加到 .vscode/mcp.json。 |
| 任何其他 MCP 客户端 | 任何支持通过 Streamable HTTP 和 OAuth 2.1 登录连接远程服务的客户端,都可以用相同方式连接。 |
适用于接受 URL 的客户端的通用配置:
{ "mcpServers": { "thumbs": { "url": "https://mcp.usethumbs.com/mcp" } } }
服务详情
| 传输方式 | Streamable HTTP |
| 身份验证 | 使用 Google 登录的 OAuth 2.1(动态客户端注册、PKCE S256) |
| 端点 | https://mcp.usethumbs.com/mcp |
| 访问权限 | 允许列表:已获准加入的候补名单账户 |
| 注册表名称 | com.usethumbs/thumbs(见 server.json) |
未通过身份验证的请求会收到带有指向 OAuth 元数据的 WWW-Authenticate 标头的 401 响应。这是预期行为。
实测数据
在真实的 iPhone 17 Pro 上,2026 年 10 月 23 日,由开发者运行(并非早期访问目前使用的 Simulator):截图约需 63 毫秒;点击耗时 0.4 至 0.8 秒,具体取决于应用;20 分钟内运行了 296 条命令,全部成功;某语言学习应用的 19 屏引导流程在 3.2 分钟内走到了付费墙。
限制
- 早期体验仅适用于 iOS Simulator:Safari 和 Apple 内置应用,不包括 App Store 应用。它不是真实设备。
- 测试者会轮流共用该模拟器,每次最多 30 分钟。请勿在上面登录个人账户;我们和下一位测试者可能会看到留在上面的任何内容,且这些内容可能会被删除。
- 不可使用银行应用、Apple Pay,也不可使用任何需要 Face ID 的功能。
- 服务可能运行缓慢、无法使用,或随时发生变化。早期体验按现状提供,不作任何保证。
使用政策
请仅将 thumbs 用于你自己的应用、账户和研究。请勿将其用于发送垃圾信息、创建虚假账户、规避应用规则或安全措施、伤害他人或从事任何违法活动。请勿尝试破坏、使服务过载或对其进行逆向工程。你需对 Agent 的行为负责,并确保你有权测试所指定的应用。完整条款:条款 · 隐私。
链接
- 网站和候补名单:usethumbs.com
- 指南:usethumbs.com/guides
- 联系方式:[email protected]
- 创作者:Jorge García González。
许可证
本仓库中的文档根据 MIT License 发布。“thumbs”和 thumbs 徽标不受该许可证保护。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。