v0.1.0 — Phase 0 MVP
Android Phone MCP Server v0.1.0 (Phase 0 MVP)
代码 Agent 无关的 Android 控制 MCP Server：语义动作 + 验证闭环 + 融合感知。
12 个 MCP 工具
list_devices get_device_info get_screen get_screen_hash tap swipe scroll_page type_text scroll_until open_app open_settings press_key
核心能力
- 语义选择器（text/desc/id）+ SELECTOR_AMBIGUOUS 消歧，坐标仅服务端传递
- 动作后验证证据三件套 {executed, screen_changed, changed_elements[], screen_hash}
- 滚动优化：末尾检测（reached_end）、原生一屏滚动、scroll_page 工具
- 默认只读 + 双通道 30s 超时 + 注入防护；结构化错误直达客户端
- 设备池 serial 隔离 + 懒加载；紧凑 text 快照（summary ~14x 压缩）+ 稳定元素 id
质量
- 93 测试全绿（80 单测 + 13 真机探针，OPPO PKT110 / Android 16）
- 代码评审 3 轮闭环（0 BLOCKER）
安装
pip install android-phone-mcp # PyPI 发布后
# 或本地: uv pip install dist/android_phone_mcp-0.1.0-py3-none-any.whl