adb_mcp_server
2
The Android ADB MCP Server allows remote control of Android devices using the MCP protocol. It supports managing devices, performing screen operations, managing files, and more. The project is designed to work with clients like Claude for Desktop for enhanced functionality.
Android ADB MCP Server
This project is an MCP protocol-based Android ADB server that allows remote control of Android devices connected to a computer via MCP clients like Claude for Desktop.
Features
- Device Management: List connected Android devices
- Screen Operations: Screenshot, tap, swipe
- Input Operations: Text input, key press
- App Management: Install/uninstall apps, start apps
- System Operations: Get screen resolution
- Network Tools: Check network status, port scanning, WiFi management
- File Tools: Upload/download files, file management
- Advanced Tools: UI testing, performance analysis, screen recording, log collection, enhanced app launching
Prerequisites
- Python 3.10 or higher
- ADB installed and added to the system path
- Android device with USB debugging enabled and connected
Installation
Clone the repository, install dependencies, and ensure the ADB server is running.
Usage
Configure in Claude for Desktop
- Install Claude for Desktop
- Configure MCP server with provided settings
- Restart Claude for Desktop
Configure in Cursor
- Edit the MCP file
- Add the configuration
- Restart Cursor
Supported Tools
- Device Management: Listing devices
- Screen Operations: Screenshot, tap, swipe
- Input Operations: Text input, press keys
- App Management: Start, install, uninstall apps
- System Operations: Screen resolution
- Network Tools: IP, WiFi status, port scan
- File Tools: File listing, upload, download, management
- Advanced Tools: UI testing, performance analysis, screen recording
Usage Examples
- Interact with and manage devices using statements in Claude for Desktop like installing apps or capturing screenshots.
Tips
- Ensure ADB server is running
- Enable USB debugging on the Android device
- Some operations may require root access
- Use enhanced app launching for permission issues
Contribution
Contributions are welcome via Pull Requests or Issues.
License
MIT © wolfcoming