1 v0.2.0 更新于 2026-10-10
ERIUS PHONE MCP Server
操控托管的 ERIUS PHONE 安卓设备：读取屏幕、点按、输入、安装 APK、获取崩溃日志。
适用客户端
本地客户端
Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端
安装配置
本地运行(pypi)
{
"mcpServers": {
"erius-phone-mcp": {
"command": "uvx",
"args": [
"erius-phone-mcp"
]
}
}
}将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。
提供的工具 接入后 Agent 可调用这 20 个工具
whoami
显示当前服务器使用的账户、密钥及可访问的设备 ID,用于快速验证密钥是否有效。
list_devices
列出密钥可访问的所有设备及其实时状态(启动、Android 版本、屏幕尺寸)。
get_device
获取单个设备的完整状态,包括当前前台应用。
snapshot
以无障碍树形式获取当前屏幕快照,包含每个可见元素的文本、角色及可用于点击/输入/滚动的 ref。
screenshot
以 MCP 图像内容形式返回屏幕截图,可自定义格式、质量、尺寸等。
foreground
获取前台应用(包名、Activity)及是否显示崩溃对话框。
wait_for_text
等待指定文本出现在屏幕上,最多 timeout_ms(最大 120000),并返回看到的快照。
tap
按 ref、可见文本/content_desc 或原始 x,y 坐标点击屏幕。
long_press
按 ref、文本或坐标长按屏幕,可指定按住时长。
type_text
向输入框输入文本,可先点击目标、清空输入框并在输入后按回车。
press_key
按键,支持返回、主页、回车、删除、方向键、音量等常用键或数字键码。
swipe
在设备像素坐标的两个点之间滑动。
scroll
对指定容器(ScrollView/List)进行上/下/左/右滚动。
launch_app
按包名启动已安装的应用。
open_url
打开 http/https/market URL,可选指定在哪个应用中打开。
send_intent
以任意 intent action 启动 Activity,可附带数据、包名、组件和 extras。
stop_app
强制停止一个应用。
list_apps
列出已安装应用,可通过 third_party_only 只列出用户安装的应用。
install_apk
从服务器所在机器上传并安装 APK,返回包名、版本及是否安装成功。
uninstall_app
按包名卸载应用。