Longarm 文档

本页是 longarm 文档的快速入口。当你需要从脚本、桌面工具、测试环境或兼容 MCP 的 Agent 控制 Android 设备时，可以从这里开始。

文档页面

• REST API
• MCP 服务器
• 批处理任务
• 日志与历史记录

longarm 能做什么

longarm 运行在 Android 设备上，并提供：

• 用于直接远程控制的 HTTP REST API
• 面向 Agent 与工具工作流的 streamable HTTP MCP 服务器
• 可保存并重复使用的批处理任务

主要支持的动作包括：

• 点击与长按
• Plus 手势，例如滑动、捏合、双指滑动和旋转
• 截图
• 启动应用和自定义 Android Intent
• 可选的 UI 检查与语义化 UI 操作

首次配置

1. 安装并打开 longarm。
2. 为 longarm 启用 Android 无障碍服务。
3. 如果要使用悬浮气泡，请授予悬浮窗权限。
4. 在 Settings 中检查 HTTP 端口、MCP 端口、bearer token 认证、监听地址以及 UI inspection 选项。
5. 在应用内启动 HTTP 服务器和/或 MCP 服务器。

安全模型

• 默认情况下，longarm 要求 Authorization: Bearer <token>。
• 如果关闭认证，任何能访问该网络的设备都可以调用服务器。
• 只有在 bearer token 认证保持启用，且 Allow UI inspection 打开时，UI inspection 功能才可用。

REST API

HTTP 服务器通过 /api/... 提供手势、截图、应用启动、Android Intent、UI 检查和批处理自动化接口。

阅读 REST API 文档。

MCP

longarm 还提供 streamable HTTP MCP 服务器，让兼容的 Agent 和工具可以直接调用 Android 控制动作。

阅读 MCP 文档。

批处理任务

批处理任务用于保存可复用的 Android 自动化流程，并可从应用、REST API 或 MCP 运行。

阅读批处理任务文档。

详细日志与历史记录

longarm 将 REST/MCP 请求日志与批处理运行历史分开保存，便于同时检查单次调用和完整工作流。

阅读日志与历史记录文档。

推荐工作流

1. 启动 HTTP 或 MCP 服务器。
2. 复制应用中显示的主机和端口。
3. 直接脚本调用时使用 REST API，需要 Agent 集成时使用 MCP。
4. 将重复流程保存为批处理任务。
5. 在 longarm 内查看 Logs 标签页和 Batch History 标签页。