Zeptap

Name: Zeptap
Author: Zeptap

本地服务

zeptap.com开发工具101 周前更新

代码仓库访问官网

关于 Zeptap

Zeptap 是一款 Mac 应用及配套 MCP 配置，可让 Agent 操作真实 iPhone。它适用于实体设备上的 iOS 测试和日常手机任务，并在每次操作后返回截图以供核验。

主要功能

01通过 USB 和蓝牙控制真实 iPhone
02截取屏幕并用 OCR 读取文字
03点击、滑动、输入和打开应用
04每次操作后返回截图
05支持多台已连接的 iPhone

适用场景

01在实体 iPhone 上测试 iOS 应用
02走查应用注册流程并截取各屏幕
03更改设置或完成手机任务
04操作多台已连接的 iPhone

MCP 相关

Zeptap 在 http://127.0.0.1:47801/mcp 提供本地 Streamable HTTP MCP 服务，也提供供 stdio 客户端使用的中继程序。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "zeptap-zeptap": {
      "command": "npx",
      "args": [
        "-y",
        "@zeptap/mcp"
      ]
    }
  }
}

启动命令npx -y @zeptap/mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@zeptap/mcp1.0.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

让 AI Agent 在真实 iPhone 上查看、点击、滑动和输入。
适用于 Zeptap Mac 应用的 MCP 配置、Claude Code 插件、Agent 技能和 stdio 中继。

它是什么

Zeptap 是一款 Mac 应用，可让 AI Agent 操作真实 iPhone。Mac 通过 USB 读取 iPhone 屏幕，并通过 AssistiveTouch 使用蓝牙发送点击和输入。该应用会在本地运行 MCP 服务 http://127.0.0.1:47801/mcp（Streamable HTTP，仅限回环地址，无需身份验证）。每项操作都会返回一张屏幕截图，让 Agent 检查自己的操作结果。

你可以用它在实体设备上测试自己的 iOS 应用，也可以把日常手机任务交给你正在使用的 Agent。

“打开我的应用并走完注册流程” · “截取深色模式下的每个屏幕” · “开启低电量模式” · “在设置中查找 Wi-Fi 密码”

本仓库包含客户端配置、插件、技能和中继，不包含应用本身。

了解须知

🔌 iPhone 上无需安装任何内容。 无需 Xcode、无需开发者模式，也无需 Apple Developer 账户。手机上唯一要做的就是配对蓝牙。

📱 使用真实 iPhone，而非模拟器。 App Store 应用、设置、Safari、信息、TestFlight 版本，只要你能点击，Agent 就能操作。

🔒 仅限本地使用。 MCP 服务只接受来自同一台 Mac 的连接。屏幕截图只会发送给你连接的 Agent。请参阅隐私。

💳 Mac 应用付费，首小时免费。 Mac 应用为闭源。首次实时使用一小时后，费用为每月 25 美元、一次性支付 99 美元，或一次性支付 199 美元（最多支持 5 部 iPhone）。请参阅价格。本仓库中的所有内容均采用 MIT 许可证。

开始使用

下载 Zeptap，或运行 brew install --cask zeptap/tap/zeptap。
连接你的 iPhone，使用 USB 线连接，轻点“信任”，并在设置助手中配对蓝牙。
将服务添加到你的 Agent（见下文），然后让它截取屏幕截图。

你需要： 一台运行 macOS 14 或更高版本且支持蓝牙的 Mac、一部 iPhone 和一根 USB 线。

连接你的 Agent

Claude Code

claude mcp add --transport http --scope user zeptap http://127.0.0.1:47801/mcp

或者安装插件，它会添加服务和技能：

/plugin marketplace add zeptap/mcp
/plugin install zeptap@zeptap

Cursor

~/.cursor/mcp.json：

{ "mcpServers": { "zeptap": { "url": "http://127.0.0.1:47801/mcp" } } }

Codex

~/.codex/config.toml：

[mcp_servers.zeptap]
url = "http://127.0.0.1:47801/mcp"

VS Code

.vscode/mcp.json：

{ "servers": { "zeptap": { "type": "http", "url": "http://127.0.0.1:47801/mcp" } } }

Claude Desktop 和其他 stdio 客户端

{ "mcpServers": { "zeptap": { "command": "npx", "args": ["-y", "@zeptap/mcp"] } } }

或者使用不依赖 Node 的方式：

{ "mcpServers": { "zeptap": { "command": "/Applications/Zeptap.app/Contents/MacOS/Zeptap", "args": ["--stdio"] } } }

检查是否正常工作（确保 Zeptap 已打开）：

curl -s http://127.0.0.1:47801/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

工具

工具	功能
`list_phones`	此 Mac 已连接的 iPhone，以及可传入 `phone` 的 ID
`screenshot`	当前 iPhone 屏幕截图
`find_text`	对屏幕文本进行设备端 OCR，可选择筛选条件
`wait`	等待后返回稳定的屏幕截图
`load_skill`	返回内置应用指南
`tap`、`double_tap`、`long_press`	轻触、双击或长按坐标 x、y
`tap_text`	轻触可见的文本标签
`drag`、`flick`	在两点之间拖动，或朝某个方向滚动
`type_text`、`press_key`	输入文本，或按下带修饰键的按键
`home`、`back`、`dismiss`	返回主屏幕、返回上一级、关闭面板或键盘
`open_app`	按名称打开已安装的应用
`lock`、`unlock`	通过 USB 锁定；使用保存在钥匙串中的密码解锁（可选）

每个操作都会在屏幕稳定后返回截图。除 list_phones 外，所有工具都可选传入 phone；如果不传入，工具会操作 Zeptap 中当前激活的 iPhone。完整参考：zeptap.com/docs/agents/tools。

此仓库包含什么

路径	内容
`skills/zeptap/SKILL.md`	Agent 技能：连接检查、观察-操作-验证循环，以及何时应先询问。复制到 `~/.claude/skills/` 或安装插件
`.claude-plugin/`	Claude Code 插件和市场清单
`.mcp.json`	插件安装的 MCP 配置
`bin/zeptap-mcp.js`	`@zeptap/mcp`，一个启动 `Zeptap --stdio` 的标准输入/输出中继。如果应用不在 `/Applications` 中，请设置 `ZEPTAP_BIN`
`server.json`、`smithery.yaml`	注册表清单