📱 Phone MCP Plugin
@hao-cyber
A phone control plugin for MCP that allows you to control your Android phone through ADB commands to connect any human
概要
What is 📱 Phone MCP Plugin?
An MCP plugin that controls Android phones via ADB commands, enabling call, SMS, contact, media, app, UI automation, and screen analysis through AI assistants.
How to use 📱 Phone MCP Plugin?
Install with uvx phone-mcp (recommended), uv pip install phone-mcp, or pip install phone-mcp. Configure the MCP server in your AI assistant (Cursor, Trae, Claude, etc.) using the JSON block provided. Ensure ADB is installed, USB debugging is enabled, and the Android device is connected via USB. Use natural language commands like “Please call contact hao” in Claude.
Key features of 📱 Phone MCP Plugin
- Call management (make, end, receive calls)
- SMS send/receive with pagination
- Contact access and creation via UI automation
- Screenshots, screen recording, media control
- App launch by name, package, or explicit activity
- Screen analysis and unified interaction (tap, swipe, key, text, find, wait, scroll)
- UI monitoring for element appearance/disappearance
Use cases of 📱 Phone MCP Plugin
- Automatically play music based on the current weather from the browser.
- Call a contact and send a follow‑up SMS if they don’t answer.
- Automate onboarding flows: fill fields, tap buttons, wait for success.
- Search for nearby POIs and dial a phone number.
- Monitor UI changes during long‑running tasks and react accordingly.
FAQ from 📱 Phone MCP Plugin
What are the requirements to use this server?
Python 3.7+, an Android device with USB debugging enabled, and ADB tools must be installed and configured.
How do I find the Python path for the configuration?
On Linux/macOS run which python3 or which python. On Windows run where python in CMD or (Get-Command python).Path in PowerShell.
What if the app or open_app command doesn’t launch an app?
Use the launch command with the full component name (package/activity). For example: phone-cli launch com.android.dialer/com.android.dialer.DialtactsActivity.
Where does the data (contacts, messages, etc.) come from?
All data comes directly from the connected Android device via ADB. No external cloud services are used.
Is the server transport secure?
The server uses ADB over USB; standard MCP transport (stdio) is used. No authentication or encryption beyond ADB’s own security is mentioned.
