@cjwddz/android-server

面向 AI Agent 的自托管 Android 模拟器服务。

系统要求

• KVM — 硬件虚拟化支持（ls /dev/kvm）
• Android SDK — emulator + platform-tools（ADB）
• AVD — 至少一个已创建的 Android Virtual Device
• Xvfb + x11vnc — 虚拟显示和 VNC

# Ubuntu/Debian
sudo apt-get install -y xvfb x11vnc qemu-kvm

# Android SDK (手动安装)
# 1. 下载 command-line tools: https://developer.android.com/studio#command-tools
# 2. sdkmanager "emulator" "platform-tools" "system-images;android-34;google_apis;x86_64"
# 3. avdmanager create avd -n default -k "system-images;android-34;google_apis;x86_64"

安装

npm install -g @cjwddz/android-server

使用

android-server start -u admin -p yourpassword
android-server stop
android-server restart -u admin -p yourpassword
android-server status

启动后打开 http://localhost:33000，创建会话，复制 MCP 配置到 Agent。

MCP 工具

| 工具 | 说明 | |------|------| | tap | 点击屏幕坐标 | | swipe | 滑动 | | type_text | 输入文本（ASCII） | | broadcast_text | 输入文本（支持中文，需 ADBKeyboard） | | press_key | 按键（BACK, HOME, ENTER 等） | | take_screenshot | 截屏 | | get_ui_tree | 获取 UI 控件树（XML） | | open_url | 打开 URL | | open_app | 启动应用 | | install_app | 安装 APK | | list_apps | 列出已安装应用 | | get_current_activity | 获取当前 Activity | | shell | 执行 ADB shell 命令 | | get_screen_size | 获取屏幕分辨率 | | wait | 等待指定时间 |

License

MIT