📱 Complemento MCP de teléfono

🌟 Un poderoso complemento MCP que te permite controlar tu teléfono Android con facilidad a través de comandos ADB.

⚡ Inicio rápido

📥 Instalación

pip install phone-mcp
# or use uvx
uvx phone-mcp

🔧 Configuración

Configuración del cursor

Configurar en ~/.cursor/mcp.json :

{
    "mcpServers": {
        "phone-mcp": {
            "command": "uvx",
            "args": [
                "phone-mcp"
            ]
        }
    }
}

Configuración de Claude

Añadir a la configuración de Claude:

{
    "mcpServers": {
        "phone-mcp": {
            "command": "uvx",
            "args": [
                "phone-mcp"
            ]
        }
    }
}

Uso:

Utilice comandos directamente en la conversación de Claude, por ejemplo:
Please call contact hao

⚠️ Antes de usar, asegúrese de:

ADB está correctamente instalado y configurado
La depuración USB está habilitada en su dispositivo Android
El dispositivo está conectado a la computadora a través de USB

🎯 Características principales

📞 Funciones de llamada : Realizar llamadas, finalizar llamadas, recibir llamadas entrantes
💬 Mensajería : envía y recibe SMS, recibe mensajes sin procesar
👥 Contactos : Accede a los contactos del teléfono
📸 Medios : Capturas de pantalla, grabación de pantalla, control de medios
📱 Aplicaciones : Iniciar aplicaciones, configurar alarmas, enumerar aplicaciones instaladas, finalizar aplicaciones
🔧 Sistema : Información de la ventana, accesos directos a aplicaciones
🗺️ Mapas : Busca puntos de interés con números de teléfono
🖱️ Interacción de la interfaz de usuario : toque, deslice, escriba texto, presione teclas
🔍 Inspección de UI : busque elementos por texto, ID, clase o descripción
🤖 Automatización de la interfaz de usuario : esperar elementos, desplazarse para encontrarlos, supervisar los cambios de la interfaz de usuario
🧠 Análisis de pantalla : información de pantalla estructurada e interacción unificada
🌐 Navegador web : abre URL en el navegador predeterminado del dispositivo

🛠️ Requisitos

Python 3.7+
Dispositivo Android con depuración USB habilitada
Herramientas del BAD

📋 Comandos básicos

Dispositivo y conexión

# Check device connection
phone-cli check

# Get screen size
phone-cli screen-interact find method=clickable

Comunicación

# Make a call
phone-cli call 1234567890

# End current call
phone-cli hangup

# Send SMS
phone-cli send-sms 1234567890 "Hello"

# Check messages
phone-cli messages --limit 10

# Get contacts
phone-cli contacts --limit 20

Medios y aplicaciones

# Take screenshot
phone-cli screenshot

# Record screen
phone-cli record --duration 30

# Launch app
phone-cli app camera

# Close app
phone-cli close-app com.android.camera

# List installed apps
phone-cli list-apps --filter camera --third-party

# Launch specific activity
phone-cli launch com.android.settings/.Settings

# Open URL in default browser
phone-cli open-url google.com

Análisis e interacción de pantalla

# Analyze current screen with structured information
phone-cli analyze-screen

# Unified interaction interface
phone-cli screen-interact <action> [parameters]

# Tap on element by text
phone-cli screen-interact tap element_text="Login"

# Tap at coordinates
phone-cli screen-interact tap x=500 y=800

# Swipe gesture (scroll down)
phone-cli screen-interact swipe x1=500 y1=1000 x2=500 y2=200 duration=300

# Press key
phone-cli screen-interact key keycode=back

# Input text
phone-cli screen-interact text content="Hello World"

# Find elements
phone-cli screen-interact find method=text value="Login" partial=true

# Wait for element
phone-cli screen-interact wait method=text value="Success" timeout=10

# Scroll to find element
phone-cli screen-interact scroll method=text value="Settings" direction=down max_swipes=5

# Monitor UI changes
phone-cli monitor-ui --interval 1 --duration 60

Ubicación y mapas

# Search nearby POIs with phone numbers
phone-cli get-poi 116.480053,39.987005 --keywords restaurant --radius 1000

📚 Uso avanzado

Automatización basada en pantalla

La interfaz de interacción de pantalla unificada permite a los agentes inteligentes:

Analizar la pantalla : Obtenga un análisis estructurado de los elementos de la interfaz de usuario y el texto
Tomar decisiones : según los patrones de IU detectados y las acciones disponibles
Ejecutar interacciones : A través de un sistema de parámetros consistente
Supervisar cambios : observe continuamente los cambios de la interfaz de usuario y responda automáticamente

📚 Documentación

Para obtener la documentación completa y los detalles de configuración, visita nuestro repositorio de GitHub .

📄 Licencia

Licencia Apache, versión 2.0

Phone MCP Plugin

Integrations