github-hewei/mcp-android-adb-server

An MCP service for operating Android devices via ADB.
2025-04-01: Added support for obtaining screen description content using visual models like qwen2.5-vl.
### Manual Installation
sh
# clone the repo and build
git clone https://github.com/github-hewei/mcp-android-adb-server.git
cd mcp-android-adb-server
go build
### Configuration
json
"mcpServers": {
"mcp-android-adb-server": {
"command": "D:\\www\\golang\\mcp-android-adb-server\\mcp-android-adb-server.exe",
"env": {
"DEVICEID": "xxxxx",
"SCREENLOCKPASSWORD": "123456",
"VISUALMODELON": "true",
"VISUALMODELAPIKEY": "sk-or-xxxxxxxxxxxxxxxxxxx",
"VISUALMODELBASEURL": "https://openrouter.ai/api/v1/",
"VISUALMODELNAME": "qwen/qwen2.5-vl-72b-instruct:free"
### Environment Variables
DEVICEID : Required. The ID of the Android device, obtainable via the adb devices command.
SCREENLOCKPASSWORD : Optional. The screen lock password of the device, used to unlock the screen.
VISUALMODELON : Optional. Whether to enable the visual model, defaults to false.
VISUALMODELAPIKEY : API Key.
VISUALMODELBASEURL : API Base URL.
VISUALMODELNAME : Model name.
### Features and Tools
Application Management
installapp : Install an application on the Android device
uninstallapp : Uninstall an application from the Android device
terminateapp : Terminate a running application on the Android device
launchapp : Launch an application on the Android device
listapp : List all installed applications on the Android device
isappinstalled : Check if a specific application is installed
Screen Control
unlockscreen : Unlock the Android device screen
lockscreen : Lock the Android device screen
isscreenlocked : Check if the Android device screen is locked
isscreenactive : Check if the Android device screen is active
Input Control
inputtext : Input text on the Android device
inputkey : Input key press on the Android device
tap : Perform a tap operation on the screen at a specified position
longtap : Perform a long press operation on the screen at a specified position
back : Perform a back operation
Gesture Control
swipeup : Perform a swipe up gesture on the Android device screen
swipedown : Perform a swipe down gesture on the Android device screen
swipeleft : Perform a swipe left gesture on the Android device screen