客户端命令行
ios mcp
将已连接 iOS 真机的操作能力作为本地 MCP 服务提供给兼容客户端。
更新于
fushou-agent ios mcp 启动本地 MCP 服务，让兼容的 MCP 客户端操作选定的 iOS 真机。该命令仅支持 macOS，并由 MCP 客户端通过标准输入输出管理。首次工具调用前需通过 fushou-agent login 登录，登录过期后请重新登录。
收费与连接要求
MCP 与 RPA 脚本执行共用分钟单价，标准价为 0.1 元/分钟。首次工具调用前检查登录与余额并预扣一分钟费用，随后 60 秒内的调用共用付费窗口；满一分钟后的下一次调用重新检查并扣费。仅启动、发现工具或保持空闲不产生费用。首次扣费后即使使用不足一分钟、退出进程或工具执行失败，已扣费用也不退还。多个 MCP 进程分别计费。
限时免费：截至 2026 年 12 月 31 日，此功能免费；之后恢复标准价格 0.1 元/分钟。当前实际价格以价格页面为准。
调用需要连接赋手智能体服务器。登录失效时提示重新登录；余额为负时提示充值，充值后再次调用可恢复。计费接口失败时工具调用会失败，请检查网络后重试。重新登录或充值后，未到期的同账号付费窗口可以继续使用。
命令格式
fushou-agent ios mcpMCP 客户端配置
将 <FUSHOU_AGENT_BIN> 替换为客户端可执行文件的绝对路径：
{
"mcpServers": {
"fushou-agent-ios": {
"type": "stdio",
"command": "<FUSHOU_AGENT_BIN>",
"args": ["ios", "mcp"]
}
}
}进程持续运行到 MCP 客户端关闭。MCP 客户端会自动发现当前版本可用的 iOS 工具。
可用工具
当前版本提供以下 14 个工具。工具参数由 MCP 客户端自动获取；涉及屏幕坐标的操作应以最近一次 get_phone_state 返回的截图为准。
| 工具 | 用途 |
|---|---|
read | 通过绝对路径读取运行客户端 Mac 上的本地文本文件或 PNG/JPEG 图片。 |
bash | 在运行客户端的 Mac 上执行本地 shell 命令，不在 iOS 设备中执行。 |
get_phone_state | 获取 iOS 设备当前应用的状态和截图，供后续界面操作定位。 |
list_apps | 列出设备上已安装应用的显示名称和 iOS bundle ID。 |
launch_app | 按 list_apps 返回的名称或 iOS bundle ID 启动应用；需要打开应用首页时可设置 homepage=true。 |
transfer_file_to_phone | 将 Mac 上的一个现有文件传至设备。photos 用于将受支持的图片加入系统照片图库；app_documents 可将任意文件保存到指定应用的 Documents/FushouAgent，且该应用必须支持 iOS 文件共享。名称冲突时自动重命名。 |
tap | 点击屏幕上的指定坐标点。 |
type_text | 清空当前聚焦的输入框并输入原样 Unicode 文本。 |
swipe | 从一个屏幕坐标点滑动到另一个坐标点。 |
back | 通过 iOS 标准左边缘滑动手势返回上一页。 |
home | 返回 iOS 主屏幕。 |
double_tap | 双击屏幕上的指定坐标点。 |
long_press | 在指定坐标点长按 3 秒。 |
wait | 等待界面稳定并返回当前状态；单次最长等待 60 秒。 |
环境变量
| 变量 | 必填 | 默认值 | 说明 |
|---|---|---|---|
FUSHOU_WDA_URL | 否 | USB 模式 | 外部或无线 WebDriverAgent 地址；未设置或为空时使用 USB 模式。 |
仅在连接外部 WebDriverAgent 时配置相应环境变量；修改后重启 MCP 服务。
设备要求
在 macOS 上为目标设备签名并部署 WebDriverAgent，信任当前电脑，并完成所需组件安装。请仅连接一台目标设备。使用 FUSHOU_WDA_URL 时，确保当前电脑可以访问该地址。
常见错误
- 服务启动后立即退出：在终端运行相同命令，检查 stderr 中的设备或工具错误。
- 找不到命令：在 MCP 配置中使用
fushou-agent的绝对路径。 - 找到多台设备：断开其他设备，仅保留目标设备。
- WebDriverAgent 不可用：确认它已为目标设备签名、部署并启动。