搜索你想找的开源项目

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

分享到微信

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

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

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

ananhq/anan-iphone-use

硬件与物联网

把 M5Stack StopWatch(ESP32-S3)变成 MCP 服务器,向 iPhone 发送点击、拖拽、滚动和键盘输入的固件。

160
22
C
GPL-3.0
创建于 36 天前

项目介绍

这是一个面向 M5Stack StopWatch(ESP32-S3)的 ESP-IDF 固件,在设备上运行 HTTP MCP 服务器。手机或电脑上的 Agent 负责观察 iPhone 屏幕并决定操作,StopWatch 把 MCP 工具调用转换成点击、拖拽、滚动和键盘输入,通过 USB 或实验性 BLE 发给 iPhone。固件本身不运行模型,也不采集截图,屏幕观察始终留在客户端。

输入工具包括 tap、drag、press_key、type_ascii、scroll,以及 device_status 和 stop。坐标使用竖屏归一化的 0…1,时间单位为毫秒。项目以 Anan 客户端为主要搭配,但任何能访问 USB 子网或 Wi-Fi 局域网的 HTTP MCP 客户端都可接入;仓库附带的 skill 也覆盖其他 ESP32 板型的适配。

快速使用

需要一台 M5Stack StopWatch、用于首次刷写的电脑和数据线,以及开启 AssistiveTouch 的 USB-C iPhone。

git clone https://github.com/ananhq/anan-iphone-use.git
cd anan-iphone-use

在仓库目录中打开你的 Agent,让它使用 $anan-iphone-use 识别板型、刷写固件并配置 iPhone MCP。如果 skill 没有被发现,先阅读 skill 文件。刷写和连接步骤见 安装文档。

刷写后选择一种连接方式:

  • 无线: 加入 StopWatch 设置热点,打开 http://192.168.4.1,确认 MCP 配对,选择 2.4 GHz Wi-Fi,离开前复制 MCP 配置;随后回到常用网络,在 iPhone 上通过 BLE 配对 Anan StopWatch。无线设置与恢复同时覆盖两条路径。
  • USB: 把 StopWatch 连到 iPhone,配置 USB 以太网为 192.168.7.2、掩码 255.255.255.0、不设路由和 DNS,然后打开 http://192.168.7.1 完成配对并导入 MCP。

开启 AssistiveTouch 后,在设备上点 Start control。默认 MCP 端点为 http://stopwatch.local/mcp,USB 备用地址为 http://192.168.7.1/mcp。导入包含 Bearer 头的导出配置;在 USB 与 BLE 输入之间切换不需要重新导入。

使用约束

  • 开箱仅支持 M5Stack StopWatch(ESP32-S3),其他板型需要自行适配。
  • Wi-Fi 必须为 2.4 GHz 且处于可访问的局域网;设置热点会暂停 BLE,也不是互联网路由器,最多记住五个网络。
  • 输入仅支持竖屏、单指针和美式布局 ASCII,不能直接输入中文。
  • BLE 输入仍属实验性,指针精度、重连、客户端互通性和续航都需要真机验收;构建与离线结果记录在 validation。
  • Anan 的系统级屏幕共享要求 iOS 27 及以上。
  • 现有代码为 GPL-3.0-only;来自上游 StopWatch 头像项目的表情引擎为 AGPL-3.0-or-later,组合构建遵循 GPLv3/AGPLv3 第 13 条。

HotRepo 点评

该仓库没有记录到 GitHub 日榜名次、Star 快照或 Hacker News 讨论,因此没有可解读的热度趋势。可参考的信息在于结构:目标硬件很窄,但职责划分清楚——Agent 提供视觉和决策,固件只负责输入。七个 MCP 方法及参数都有文档,接口面容易核查;代价是项目能否发挥价值取决于能观察 iPhone 屏幕的客户端,README 主要指向 Anan,而其开源版本尚未发布。购买 StopWatch 前,应先把实验性 BLE 和竖屏、仅 ASCII 的限制考虑进去,不要把它当成通用手机自动化方案。

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

相关推荐

  1. onehumanbeing/esp32-iphone-agent用一块约 7 美元的 ESP32 当 AirPlay 接收端和 USB 鼠标键盘,让视觉模型操控真实的 iPhone。C3,790
  2. 78/xiaozhi-esp32把常见 ESP32 开发板变成语音助手终端的固件,含唤醒词与 MCP 设备控制。C++31,875
  3. Liu-zhongxian/zongzhu-bot圆屏 ESP32-S3 桌面语音终端:板子负责听和说,电脑后端识别语音并分发任务,其余交给 Grok Bot。C++220
  4. m5stack/StackChan面向 M5Stack StackChan AI 桌面机器人,汇集固件、遥控器、手机应用与服务端的开源资源。Go1,476
  5. socquique/TamaPoke为特定圆形 AMOLED ESP32-S3 板卡打造的开放固件电子宠物,支持浏览器一键烧录。C++221