AndroidMCP

项目概述

AndroidMCP 是一个面向 Android 11+ 设备的 MCP 服务器，用 C# 与 .NET 8 实现，直接说 ADB 协议而非外包给命令行解析，让 Claude Code 等 MCP 客户端能够截屏、读取界面树、点击滑动与管理应用。

它内置 30 余个工具，支持按 serial 管理多台设备，并可在设备上部署 Agent 服务加速 UI 操作。Windows 与 Linux 提供安装脚本，可自动把配置合并进 ~/.claude.json。

项目	内容
平台	Windows、Linux x86_64（主机侧）
设备要求	Android 11+，adb 在 PATH 中
技术栈	C# .NET 8，直连 ADB 协议
许可	Apache-2.0

让编程代理真正动手操作 Android 设备：截屏、点按、装包一应俱全。

主要功能

• 设备枚举与信息：list_devices 列出 adb 可见设备，device_info 与 screen_size 返回设备与屏幕详情
• 屏幕与界面树：screenshot 输出 PNG，dump_hierarchy 返回精简 JSON 或原始 XML 视图树
• 元素级操作：find_element、tap_element、wait_for_element 与 scroll_until_visible 支持选择器定位与稳定滚动
• 输入与按键：click、long_press、swipe、input_text、key_event 及 home/back/recents 等系统键
• 应用管理：install_apk、list_packages、launch_app、stop_app、clear_app_data 与启停包体
• 文件与 Shell：push_file、pull_file 双向拷贝，shell 执行任意 adb shell 命令
• 设备端 Agent：agent-server JAR 在设备上运行，加速截图与 UI 操作
• 一键安装：Windows 与 Linux 脚本拉取最新版，可用 AutoConfig 自动写入 Claude Code 配置

适用人群

• 用 Claude Code 做 Android 自动化的开发者
• 需要脚本化测试 App 界面的测试工程师
• 管理多台真机或模拟器的设备农场维护者
• 想让 AI 代理代劳重复手机操作的玩家

快速上手

1. 确认 adb 已安装并在 PATH 中，设备已开启 USB 调试
2. 运行 PowerShell 或 Shell 安装脚本，需要时加 AutoConfig 参数
3. 在 Claude Code 中执行 /reload-plugins 加载工具
4. 先调用 list_devices 拿到 serial，再按 serial 使用其他工具
5. 设备在锁屏时先调用 wake_unlock 唤醒

核心优势

• 直连协议：不走命令行拼凑，ADB 交互更稳更快
• 工具面广：从截屏到装包，30 余个工具覆盖常见设备操作
• Agent 加速：设备端服务分担 UI 操作，响应更迅速
• 安装省心：脚本化部署并可自动合并配置，装完即用

系统要求

项目	要求
主机系统	Windows 或 Linux x86_64
运行时	Linux 版自包含，无需 .NET 运行时
设备系统	Android 11 及以上
依赖	adb 在 PATH 中

注意事项

• 需要 adb：所有能力依赖主机上可用的 adb，请先安装平台工具
• 不支持 musl：Linux 版基于 glibc，Alpine 等 musl 发行版无法运行
• shell 工具无过滤：shell 可执行任意 adb shell 命令（60 秒超时），请只对可信设备使用
• AutoConfig 改配置：自动配置会合并写入 ~/.claude.json，介意者可手动添加配置段