android mcp - 赋手智能体文档

fushou-agent android mcp 启动本地 MCP 服务，让兼容的 MCP 客户端操作选定的 Android 设备，并由 MCP 客户端通过标准输入输出管理。首次工具调用前需通过 fushou-agent login 登录，登录过期后请重新登录。

收费与连接要求

MCP 与 RPA 脚本执行共用分钟单价，标准价为 0.1 元/分钟。首次工具调用前检查登录与余额并预扣一分钟费用，随后 60 秒内的调用共用付费窗口；满一分钟后的下一次调用重新检查并扣费。仅启动、发现工具或保持空闲不产生费用。首次扣费后即使使用不足一分钟、退出进程或工具执行失败，已扣费用也不退还。多个 MCP 进程分别计费。

限时免费：截至 2026 年 12 月 31 日，此功能免费；之后恢复标准价格 0.1 元/分钟。当前实际价格以价格页面为准。

调用需要连接赋手智能体服务器。登录失效时提示重新登录；余额为负时提示充值，充值后再次调用可恢复。计费接口失败时工具调用会失败，请检查网络后重试。重新登录或充值后，未到期的同账号付费窗口可以继续使用。

命令格式

fushou-agent android mcp

MCP 客户端配置

将 <FUSHOU_AGENT_BIN> 替换为客户端可执行文件的绝对路径：

{
  "mcpServers": {
    "fushou-agent-android": {
      "type": "stdio",
      "command": "<FUSHOU_AGENT_BIN>",
      "args": ["android", "mcp"]
    }
  }
}

进程持续运行到 MCP 客户端关闭。MCP 客户端会自动发现当前版本可用的 Android 工具。

可用工具

当前版本提供以下 14 个工具。工具参数由 MCP 客户端自动获取；涉及屏幕坐标的操作应以最近一次 get_phone_state 返回的截图为准。

工具	用途
`read`	通过绝对路径读取运行客户端电脑上的本地文本文件或 PNG/JPEG 图片。
`bash`	在运行客户端的电脑上执行本地 shell 命令，不在 Android 设备中执行。
`get_phone_state`	获取 Android 设备当前应用的状态和截图，供后续界面操作定位。
`list_apps`	列出设备上可启动应用的显示名称和 Android package name。
`launch_app`	按 `list_apps` 返回的名称或 Android package name 启动应用；需要打开应用首页时可设置 `homepage=true`。
`transfer_file_to_phone`	将电脑上的一个现有文件传至设备。`gallery` 仅用于受支持的图片或视频，并将文件加入媒体库；`downloads` 可保存任意文件。名称冲突时自动重命名，并返回实际设备路径。
`tap`	点击屏幕上的指定坐标点。
`type_text`	清空当前聚焦的输入框并输入原样文本。
`swipe`	从一个屏幕坐标点滑动到另一个坐标点。
`back`	执行 Android 返回操作。
`home`	返回 Android 主屏幕。
`double_tap`	双击屏幕上的指定坐标点。
`long_press`	在指定坐标点长按 3 秒。
`wait`	等待界面稳定并返回当前状态；单次最长等待 60 秒。

客户端仅使用有效缓存中的工具。缓存缺失或不可用时，请运行对应的安装命令修复。

设备要求

首次配置时先运行 fushou-agent install --android，再按安装客户端能力中的“配置 Android 设备”开启调试并授权当前电脑。请仅连接一台目标设备。MCP 启动本身不会主动下载 ADB 或安装 ADB Keyboard，只会复用已就绪的依赖。

常见错误

服务启动后立即退出：在终端运行相同命令，检查 stderr 中的设备或 ADB 错误。
找不到命令：在 MCP 配置中使用 fushou-agent 的绝对路径。
找到多台设备：断开其他设备，仅保留目标设备。
设备状态为 unauthorized：在设备上确认调试授权后重新启动 MCP 服务。

收费与连接要求#

命令格式#

MCP 客户端配置#

可用工具#

设备要求#

常见错误#

相关主题