Enhanced ADB MCP Server
Provides comprehensive control of Android devices via ADB, including device management, UI inspection, input interaction, app management, debugging, performance profiling, network control, and accessibility testing for Flutter development and QA workflows.
Supports visual QA workflows by capturing screenshots with metadata for comparison with Figma designs, enabling design-to-implementation validation.
Enables Flutter-specific development workflows including Flutter log filtering, UI testing automation, visual QA with screenshot capture, performance testing with frame stats, and device simulation for responsive design testing.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Enhanced ADB MCP Server take a screenshot of my connected device"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Enhanced ADB MCP Server for Flutter/Android Development
A comprehensive MCP server for controlling Android devices via ADB, specifically designed for Flutter development, UI testing, and visual QA workflows.
Quick Start
# Install from PyPI
pip install r-adb-mcp-server
# Or run directly with uvx (no installation needed)
uvx r-adb-mcp-serverNote: Both the package name and command are r-adb-mcp-server.
Then add to your MCP client configuration (Claude Desktop, Cursor, etc.) - see Configuration section below.
Related MCP server: Android MCP
Features
π± Device Management
List connected devices with details
Get comprehensive device info (model, Android version, battery, etc.)
Screen specifications with DP calculations
πΈ Visual Capture
Screenshots (base64 or file)
Screen recording with start/stop control
Capture with metadata for Figma comparison
π UI Inspection
Full UI hierarchy dump (XML)
Find elements by text or resource ID
Get all clickable elements with coordinates
Extract all visible text for verification
π― Input & Interaction
Tap, double-tap, long-press
Swipe and scroll (up/down/to-text)
Text input and clear
Key events (HOME, BACK, ENTER, etc.)
Tap elements by text or ID
π¦ App Management
Launch/stop/clear apps
Install/uninstall APKs
List packages with filtering
Get current activity
App info (version, install date, etc.)
π Debugging & Logs
Logcat with filtering (tag, level, package)
Flutter-specific logs
Crash logs extraction
ANR traces
β‘ Performance Profiling
Memory usage per app
CPU monitoring
GPU rendering info
Frame stats for jank detection
Battery statistics
π Network Control
Network info (WiFi status, IP)
Toggle WiFi/Airplane mode
Set/clear HTTP proxy
βοΈ Developer Options
Animation scale (speed up tests)
Show taps (for recordings)
Show layout bounds
Screen rotation control
Change resolution/density
βΏ Accessibility Testing
Font scale adjustment
TalkBack toggle
High contrast mode
Color inversion
π Emulator Features
GPS location spoofing
Simulate SMS/calls
Prerequisites
ADB installed and in your PATH
adb versionAndroid device/emulator connected with USB debugging enabled
adb devicesPython 3.10+ and optionally
uvfor running withuvxTo install
uv(optional, foruvxcommand):# macOS/Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Or with Homebrew (macOS) brew install uv # Or with pip pip install uv
Installation
From PyPI (Recommended)
# Install globally with pip
pip install r-adb-mcp-server
# Or use with uvx (no installation needed)
uvx r-adb-mcp-serverFrom Source
cd adb-mcp-server
# Using uv (recommended)
uv sync
# Or using pip
pip install -e .Configuration
Claude Desktop
Using installed package (recommended):
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"adb": {
"command": "uvx",
"args": ["r-adb-mcp-server"]
}
}
}Or if installed with pip:
{
"mcpServers": {
"adb": {
"command": "r-adb-mcp-server"
}
}
}Using from source:
{
"mcpServers": {
"adb": {
"command": "uv",
"args": ["--directory", "/path/to/adb-mcp-server", "run", "python", "src/adb_mcp_server/server.py"]
}
}
}Cursor IDE
Add to .cursor/mcp.json:
Using installed package (recommended):
{
"mcpServers": {
"adb": {
"command": "uvx",
"args": ["r-adb-mcp-server"]
}
}
}Using from source:
{
"mcpServers": {
"adb": {
"command": "uv",
"args": ["--directory", "/path/to/adb-mcp-server", "run", "python", "src/adb_mcp_server/server.py"]
}
}
}Claude Code
Using installed package (recommended):
claude mcp add adb -- uvx r-adb-mcp-serverUsing from source:
claude mcp add adb -- uv --directory /path/to/adb-mcp-server run python src/adb_mcp_server/server.pyGitHub Copilot
Using installed package (recommended):
Add to your VS Code settings (.vscode/settings.json or User Settings):
{
"github.copilot.chat.mcp.servers": {
"adb": {
"command": "uvx",
"args": ["r-adb-mcp-server"]
}
}
}Or if installed with pip:
{
"github.copilot.chat.mcp.servers": {
"adb": {
"command": "r-adb-mcp-server"
}
}
}Using from source:
{
"github.copilot.chat.mcp.servers": {
"adb": {
"command": "uv",
"args": ["--directory", "/path/to/adb-mcp-server", "run", "python", "src/adb_mcp_server/server.py"]
}
}
}Note: Make sure you have GitHub Copilot Chat extension installed and MCP support enabled in VS Code.
Available Tools (60+)
Device Management
Tool | Description |
| List all connected devices |
| Comprehensive device details |
| Screen size, density, DP values |
Visual Capture
Tool | Description |
| Capture as base64 PNG |
| Save screenshot to file |
| Start recording (max 180s) |
| Stop recording |
| Download recordings |
| Screenshot with metadata |
UI Inspection
Tool | Description |
| Full UI tree as XML |
| All tappable elements with coordinates |
| Find by text content |
| Find by resource ID |
| Extract all visible text |
Input & Interaction
Tool | Description |
| Tap at coordinates |
| Tap by element identifier |
| Double tap |
| Long press |
| Swipe gesture |
| Scroll screen |
| Scroll until text visible |
| Type text |
| Clear current field |
| Press any key |
| Navigation buttons |
App Management
Tool | Description |
| Current foreground app |
| Launch by package name |
| Launch specific activity |
| Force stop app |
| Clear app data |
| List installed apps |
| App details |
| Install APK |
| Uninstall app |
Debugging & Logs
Tool | Description |
| Get logs |
| Clear log buffer |
| Flutter-specific logs |
| Crash/exception logs |
| ANR traces |
Performance
Tool | Description |
| Memory usage |
| CPU usage |
| Battery details |
| GPU rendering info |
| Frame timing stats |
Network
Tool | Description |
| WiFi status, IP |
| Enable/disable WiFi |
| Toggle airplane mode |
| Set HTTP proxy |
| Clear proxy |
Developer Options
Tool | Description |
| Visual tap feedback |
| Show layout bounds |
| Animation speed (0-1) |
| portrait/landscape/auto |
| Override resolution |
| Reset to default |
| Override DPI |
| Reset to default |
Accessibility
Tool | Description |
| System font size |
| Screen reader |
| High contrast text |
| Invert colors |
Files & Shell
Tool | Description |
| Copy to device |
| Copy from device |
| List directory |
| Read text file |
| Run any shell command |
| Reboot device |
Emulator Only
Tool | Description |
| Fake GPS location |
| Simulate SMS |
| Simulate incoming call |
Example Prompts
Basic Usage
"Take a screenshot of my phone"
"What's the current screen resolution and density?"
"List all installed apps containing 'flutter'"
"What's currently on screen? Get all the text"
UI Testing
"Find the login button and tap it"
"Scroll down until you find 'Settings'"
"Get all clickable elements and their positions"
"Type 'test@email.com' into the current field"
Debugging
"Show me the last 50 Flutter logs"
"Are there any crash logs for my app?"
"What's the memory usage of com.myapp?"
Visual QA
"Capture this screen for comparison with Figma"
"Take a screenshot and tell me about the UI structure"
"Set the font scale to 1.3 and take a screenshot for accessibility testing"
Performance Testing
"Set animation scale to 0 and run through the app"
"Get frame stats for my app - is there any jank?"
"What's the GPU rendering performance?"
Device Simulation
"Change the screen to 1080x1920 to simulate a smaller phone"
"Rotate to landscape mode"
"Set location to San Francisco (37.7749, -122.4194)"
Extending
Add new tools easily:
@mcp.tool()
def my_custom_tool(param: str, device_serial: str | None = None) -> str:
"""Description shown to AI"""
return run_adb(["shell", "your-command", param], device_serial)Tips for Flutter Development
Speed up tests: Use
set_animation_scale(0)to disable animationsVisual QA: Use
capture_screen_for_comparison()with Figma MCPDebug logs:
get_flutter_logs()filters Flutter-specific outputHot reload: Keep
flutter runterminal open, use device for interactionResponsive testing: Use
change_screen_size()andchange_density()
License
MIT
Available Tools
77 toolscapture_screen_for_comparisonC
Capture screenshot with metadata for visual comparison. Saves PNG and returns info for comparing with Figma designs.
Inputs: screen_name (required), output_dir, device_serial.
change_densityC
Change screen density - useful for testing different DPI
Inputs: dpi (required), device_serial. Returns: result
change_screen_sizeB
Change screen resolution - useful for testing different screen sizes
Inputs: width (required), height (required), device_serial. Returns: result
check_flutter_app_runningC
Check if a Flutter app is currently in foreground
Inputs: device_serial.
clear_app_dataC
Clear all data for an app (like fresh install)
Inputs: package_name (required), device_serial. Returns: result
clear_logcatB
Clear the logcat buffer
Inputs: device_serial. Returns: result
clear_proxyB
Clear HTTP proxy settings
Inputs: device_serial. Returns: result
clear_text_fieldC
Clear text in current field by sending delete keys
Inputs: length, device_serial. Returns: result
double_tapC
Double tap at coordinates
Inputs: x (required), y (required), device_serial. Returns: result
find_element_by_idB
Find a UI element by its resource ID. Returns element details including tap coordinates.
Inputs: resource_id (required), device_serial. Returns: result
find_element_by_textB
Find UI elements containing specific text. Returns element details including tap coordinates.
Inputs: text (required), partial_match, device_serial. Returns: result
force_stop_appC
Force stop an app
Inputs: package_name (required), device_serial. Returns: result
get_accessibility_infoB
Get accessibility service information - useful for a11y testing
Inputs: device_serial. Returns: result
get_all_text_on_screenB
Extract all visible text from current screen. Useful for verifying text content matches designs.
Inputs: device_serial. Returns: result
get_anr_tracesC
Get ANR (Application Not Responding) traces
Inputs: device_serial. Returns: result
get_app_infoC
Get detailed information about an installed app
Inputs: package_name (required), device_serial.
get_battery_statsC
Get detailed battery statistics
Inputs: device_serial.
get_clickable_elementsB
Get all clickable/interactive elements on screen with their coordinates. Perfect for understanding what can be tapped.
Inputs: device_serial. Returns: result
get_cpu_infoC
Get CPU usage information
Inputs: device_serial. Returns: result
get_crash_logsC
Get crash/exception logs
Inputs: package_name, device_serial. Returns: result
get_current_activityB
Get the currently focused app and activity
Inputs: device_serial.
get_device_infoC
Get comprehensive device information
Inputs: device_serial.
get_element_colors_at_positionC
Note: This captures a screenshot and the caller can analyze the pixel.
For actual color extraction, use image processing on the screenshot.
Inputs: x (required), y (required), device_serial. Returns: result
get_flutter_logsD
Get Flutter-specific logs
Inputs: lines, device_serial. Returns: result
get_flutter_performance_overlayC
Get Flutter rendering performance info
Inputs: package_name (required), device_serial. Returns: result
get_frame_statsC
Get frame rendering stats for an app - useful for detecting jank
Inputs: package_name (required), device_serial. Returns: result
get_gpu_infoB
Get GPU rendering information - useful for performance debugging
Inputs: device_serial. Returns: result
get_logcatC
Get logcat output.
filter_level: V (Verbose), D (Debug), I (Info), W (Warning), E (Error), F (Fatal)
Inputs: lines, filter_tag, filter_level, package_name, +1 more. Returns: result
get_memory_infoC
Get memory usage information
Inputs: package_name, device_serial. Returns: result
get_network_infoC
Get network connectivity information
Inputs: device_serial.
get_screen_specsC
Get detailed screen specifications - useful for responsive design
Inputs: device_serial.
get_ui_hierarchyB
Dump the complete UI hierarchy as XML. Shows all visible elements, their properties, bounds, and content descriptions.
Inputs: device_serial. Returns: result
input_textA
Type text into the currently focused field
Inputs: text (required), device_serial. Returns: result
install_apkC
Install an APK file
Inputs: apk_path (required), device_serial. Returns: result
launch_activityD
Launch a specific activity
Inputs: package_name (required), activity_name (required), device_serial. Returns: result
launch_appC
Launch an app by package name
Inputs: package_name (required), device_serial. Returns: result
list_devicesB
List all connected Android devices with details
Inputs: no named parameters. Returns: result
list_filesB
List files in a directory on the device
Inputs: remote_path, device_serial. Returns: result
list_packagesB
List installed packages, optionally filtered
Inputs: filter_text, include_system, device_serial. Returns: result
long_pressC
Long press at coordinates for specified duration
Inputs: x (required), y (required), duration_ms, device_serial. Returns: result
press_backC
Press the back button
Inputs: device_serial. Returns: result
press_homeB
Press the home button
Inputs: device_serial. Returns: result
press_keyB
Press a key by keycode name or number.
Common keycodes:
- HOME (3), BACK (4), CALL (5), ENDCALL (6)
- VOLUME_UP (24), VOLUME_DOWN (25), POWER (26)
- CAMERA (27), ENTER (66), DEL/BACKSPACE (67)
- TAB (61), SPACE (62), MENU (82)
- SEARCH (84), MEDIA_PLAY_PAUSE (85)
- PAGE_UP (92), PAGE_DOWN (93)
Inputs: keycode (required), device_serial. Returns: result
press_recent_appsB
Open recent apps / app switcher
Inputs: device_serial. Returns: result
pull_fileC
Pull a file from the device
Inputs: remote_path (required), local_path (required), device_serial. Returns: result
pull_recordingsB
Pull all screen recordings from device to local directory
Inputs: local_dir, device_serial. Returns: result
push_fileC
Push a file to the device
Inputs: local_path (required), remote_path (required), device_serial. Returns: result
read_fileC
Read a text file from the device
Inputs: remote_path (required), device_serial. Returns: result
reboot_deviceC
Reboot the device.
mode: 'normal', 'bootloader', 'recovery'
Inputs: mode, device_serial. Returns: result
reset_densityB
Reset density to physical default
Inputs: device_serial. Returns: result
reset_screen_sizeB
Reset screen size to physical default
Inputs: device_serial. Returns: result
rotate_screenB
Rotate screen orientation.
orientation: 'portrait', 'landscape', 'reverse_portrait', 'reverse_landscape', or 'auto'
Inputs: orientation, device_serial. Returns: result
screenshotA
Take a screenshot of the device screen. Returns base64 encoded PNG image that can be viewed directly.
Inputs: device_serial.
screenshot_to_fileB
Save screenshot to a local file
Inputs: filename, device_serial. Returns: result
scroll_downB
Scroll down on the current screen
Inputs: device_serial. Returns: result
scroll_to_textB
Scroll until text is found on screen
Inputs: text (required), max_scrolls, device_serial. Returns: result
scroll_upB
Scroll up on the current screen
Inputs: device_serial. Returns: result
send_smsB
Send an SMS to the emulator (emulator only)
Inputs: phone_number (required), message (required), device_serial. Returns: result
set_animation_scaleA
Set animation scale (0 = off, 1 = normal, 0.5 = fast). Useful for speeding up UI tests.
Inputs: scale, device_serial. Returns: result
set_font_scaleA
Set system font scale (0.85 = small, 1.0 = normal, 1.15 = large, 1.3 = largest). Useful for testing font scaling accessibility.
Inputs: scale, device_serial. Returns: result
set_locationB
Set GPS location (works on emulators)
Inputs: latitude (required), longitude (required), device_serial. Returns: result
set_proxyB
Set HTTP proxy for the device - useful for debugging network requests
Inputs: host (required), port (required), device_serial. Returns: result
shell_commandB
Execute an arbitrary ADB shell command. Use with caution - this gives full shell access.
Inputs: command (required), device_serial. Returns: result
simulate_callC
Simulate incoming call (emulator only)
Inputs: phone_number (required), device_serial. Returns: result
start_screen_recordA
Start recording the screen. Max duration is 180 seconds.
Recording runs in background - use stop_screen_record to stop early.
Inputs: duration_seconds, filename, device_serial. Returns: result
stop_screen_recordB
Stop any ongoing screen recording
Inputs: device_serial. Returns: result
swipeC
Swipe from start to end coordinates
Inputs: start_x (required), start_y (required), end_x (required), end_y (required), +2 more. Returns: result
tapC
Tap at screen coordinates (x, y)
Inputs: x (required), y (required), device_serial. Returns: result
tap_elementB
Tap on an element by text or resource ID. More reliable than raw coordinates.
Inputs: text, resource_id, device_serial. Returns: result
toggle_airplane_modeC
Enable or disable airplane mode
Inputs: enable (required), device_serial. Returns: result
toggle_color_inversionB
Enable or disable display color inversion
Inputs: enable (required), device_serial. Returns: result
toggle_high_contrastC
Enable or disable high contrast text
Inputs: enable (required), device_serial. Returns: result
toggle_show_layout_boundsB
Show layout bounds for all views - great for debugging layouts
Inputs: enable (required), device_serial. Returns: result
toggle_show_tapsB
Show visual feedback for taps - useful for demos/recordings
Inputs: enable (required), device_serial. Returns: result
toggle_talkbackB
Enable or disable TalkBack accessibility service
Inputs: enable (required), device_serial. Returns: result
toggle_wifiC
Enable or disable WiFi
Inputs: enable (required), device_serial. Returns: result
uninstall_appC
Uninstall an app
Inputs: package_name (required), device_serial. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 77 tools
Multiple tools have overlapping or unclear boundaries, causing potential confusion. For example, 'screenshot' and 'capture_screen_for_comparison' both capture screenshots with different metadata purposes, 'clear_text_field' and 'input_text' both handle text input but with different actions, and 'tap' vs 'tap_element' vs 'find_element_by_id/text' create redundancy in UI interaction methods. While descriptions help, the sheer number of similar tools makes disambiguation challenging.
Tool names follow a mostly consistent snake_case verb_noun pattern (e.g., 'get_device_info', 'install_apk', 'toggle_wifi'), with clear action-oriented naming. There are minor deviations like 'shell_command' (which could be 'execute_shell_command' for full consistency) and some tools use gerunds ('scrolling') while others use base verbs ('tap'), but overall the naming is predictable and readable across the set.
With 77 tools, this is an extreme mismatch for an MCP server. The count is excessive and will overwhelm agents, making tool selection difficult and inefficient. While the domain (Android device testing/debugging) is broad, many tools could be consolidated (e.g., multiple screenshot methods, various toggle functions) or handled via parameters in fewer, more general tools.
The tool surface is exceptionally complete for Android device testing and debugging. It covers comprehensive CRUD/lifecycle operations for apps (install, launch, force stop, uninstall), extensive UI interaction (tap, scroll, input), system controls (reboot, proxy, settings), debugging tools (logs, performance, accessibility), and file operations. There are no obvious gaps; agents can perform end-to-end testing workflows without dead ends.
Maintenance
Related MCP Connectors
Give your AI agent a real cloud Android phone: push APKs, drive it, get screenshots and logs.
Drive real devices from your AI Coding tool. Embed a client SDK (Unity, Godot, Flutter, iOS/macOS, Android, React Native, Web) in your app, then capture screenshots, traverse the UI tree, inject taps and key events, and run automated test tasks on the physical device over a secure relay.
Drive real Android & iOS devices and web browsers from natural language for mobile + web QA. 290+ tools across device control, app management, automation sessions, browser automation, and flow recording / replay. Bearer-auth β get a token at robotactions.com β Profile β API Tokens.
Disposable cloud Android emulators for coding agents: run an APK or PR build, tap, type, screenshot.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables control of Android devices via ADB for automation and testing. Supports app management, screen capture, UI analysis, and input simulation through natural language commands.9170 npm38MIT
- FlicenseNot gradedqualityDmaintenanceEnables interaction with Android devices and emulators through ADB, allowing control actions like tapping, text input, screenshots, UI inspection, and app launching through natural language.8-
- AlicenseBqualityFmaintenanceEnables Android device control via ADB and scrcpy, including device management, app management, file operations, shell commands, input simulation, screen mirroring, and UI element inspection.2531 PyPIApache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables remote control of Android devices via ADB, including screen operations, input, app management, file transfer, and advanced tools like UI testing and performance analysis.25MIT