anan-iphone-use — ESP32 MCP 固件让 AI agent 通过 USB 控制你的 iPhone

anan-iphone-use 是一个跑在 ESP32-S3 上的 MCP 固件,让 AI agent 通过 USB 或蓝牙给你的 iPhone 发鼠标和键盘输入。这个 软件工具 由 ananhq 发布,走 GPL-3.0 协议,目前为 M5Stack StopWatch 这个硬件优化,同时带引导式板适配文档让你移植到其他 ESP32 板。作为一个 开源软件,它的分工很清楚:客户端 agent 观察屏幕、决定做什么、检查结果,固件本身不跑模型、不截图,只当一根 USB 鼠标键盘线。

场景痛点

想让 AI 操作自己的 iPhone,以前要么用 iOS 快捷指令写死流程,要么用 Mac 镜像屏幕远程点,要么用安卓调试桥那种方案但 iPhone 根本没有。做 AI应用 的人想要的,不是一个要越狱、要装描述文件、要把屏幕镜像到电脑的方案,是一个插一根 USB-C 线、agent 自己看屏幕自己点自己验证结果、用完拔掉就撤销控制的硬件外设。而且这个外设最好是开源的、能自己烧固件的、不依赖某个闭源 app。

主要功能特点

M5Stack StopWatch 即插即用的 ESP32-S3 板

固件目前针对 M5Stack StopWatch 优化,这是一块带屏幕和电池的 ESP32-S3 开发板,16MB Flash,跑 ESP-IDF v5.5.5。初始烧录需要电脑连数据线跑 build.sh 和 flash.sh,烧完之后日常使用不需要电脑。板上有实体按键,能当停止控制按钮用。项目带一份anan-iphone-use skill,你在 agent 里说一句话,它会帮你识别板子、烧固件、配 MCP。其他 ESP32 板照着 skill 里的硬件适配指南改引脚定义就能移植。这种开发者工具级别的开放硬件方案,比买个闭源外设透明。

七个 MCP 工具覆盖点按拖拽键盘滚动

固件暴露七个 Streamable HTTP MCP 工具:device_status 读连接和控制状态、tap 发单击双击长按(坐标竖屏归一化 0 到 1,可设次数和长按毫秒)、drag 发滑动拖拽画连续路径(多点坐标加持续毫秒)、press_key 发键盘编辑和系统媒体键、type_ascii 把 ASCII 文本打进焦点输入框、scroll 在指定区域垂直水平滚动、stop 中断输入撤销控制。每个输入动作限制 8 秒。坐标是竖屏归一化的,agent 不需要知道你手机物理分辨率。这种硬件驱动级别的工具面,够 agent 完成大多数日常操作。

USB 和无线两条路加 BLE 输入

连法有两种。USB 线:StopWatch 连 iPhone,在手机上配 USB Ethernet 静态 IP 192.168.7.2,浏览器开 192.168.7.1 配对导入 MCP 配置。无线:扫 StopWatch 自己的 Wi-Fi 热点二维码,配对后选 2.4GHz Wi-Fi 联网,再在 iPhone 蓝牙里配对 Anan StopWatch 用 BLE 发输入。网络通道和输入通道独立,所以 Wi-Fi 连 MCP 的同时可以用 USB 给手机发输入。手机要开 AssistiveTouch,US 硬件键盘布局。初始配对窗口十分钟,配置里带 Bearer 头要自己保存好。

固件不跑模型不截图只当输入外设

这块板子上没有模型推理,没有截图服务,你的模型 API key 不存板子上。观察屏幕靠客户端 agent——官方配的 Anan 是一个完全跑在 iPhone 上的客户端 agent,用 iOS 27+ 的系统屏幕共享把画面送给你选的视觉模型。模型出动作后通过 MCP 发给 StopWatch,StopWatch 再通过 USB 或 BLE 当鼠标键盘输进手机。每步动作完客户端要重新观察验证结果——工具返回成功只代表输入发出去了,不代表目标操作成功了。这种数字生活级别的架构,比让一个板子截屏幕再发云端隐私多了。

六个 MCP 例子真做小红书和笔记

README 里给了三段演示视频:让 agent 打开备忘录画一只小狗、打开小红书看你有多少粉丝、打开勿扰模式再设 25 分钟计时器。这些例子覆盖了画图、读数据、开设置三类操作。type_ascii 目前只支持 ASCII,不能直接打中文或 Unicode——要输中文得靠 iOS 自带的键盘预测或者粘贴。控制权限在 stop、断开 USB 或重启板子时自动撤销,重连要重新显式开控制。类似工具推荐里的实用软件和酷软趣站,想翻更多 AI 控制手机的开源方案可以看看。

官方网站

官网 https://anan.sh/iphone-use

GitHub https://github.com/ananhq/anan-iphone-use

下载地址

https://pan.quark.cn/s/4294319a98e0

https://www.guangyapan.com/s/1957650950625845302_aeWhI5wocgzRgCO6 (光鸭新用户注册福利:永久免费空间:所有新用户注册即可解锁 2TB 永久免费存储空间,无需额外任务或付费)

相关推荐

Avatar photo

JameCling

我是 格律诗的软件世界 的作者,一名专注于软件工具、AI 技术和数字效率领域的独立研究者。
多年来,我持续关注互联网工具的发展趋势,体验不同平台的软件产品,并研究它们如何帮助用户提升效率。
我的工作不仅是整理软件信息,而是通过实际测试、功能分析和使用场景研究,帮助用户判断一个工具是否真正值得使用。
格律诗的软件世界 的每一篇文章都希望提供真实、有价值的信息,包括工具特点、使用方法、优缺点分析以及适合的人群。
我相信,好的工具能够改变工作方式,而准确的信息能够帮助用户做出更好的选择。