Experimental ADB MCP server

server.py

from mcp.server.fastmcp import FastMCP
import subprocess
    

# Create an MCP server
mcp = FastMCP("ADB MCP")

@mcp.tool()
def get_devices() -> str:
    """Get the list of Android devices connected to the laptop"""
    result = subprocess.run(['adb', 'devices'], capture_output=True, text=True)
    return result.stdout

@mcp.tool()
def get_apps() -> str:
    """Use ADB to get the list of all the apps installed on a specific Android devices connected to the laptop. 
    Search through the output of this list to confirm if an app is installed."""
    result = subprocess.run(['adb', 'shell', 'pm', 'list', 'packages'], capture_output=True, text=True)
    if result.returncode != 0:
        return f"Error: {result.stderr}"
    return result.stdout


@mcp.tool()
def open_app(package_name: str) -> str:
    """Open an app on the connected Android device using its package name via ADB."""
    # The command to launch the main activity of the app
    cmd = [
        'adb', 'shell', 'monkey', '-p', package_name, '-c', 'android.intent.category.LAUNCHER', '1'
    ]
    result = subprocess.run(cmd, capture_output=True, text=True)
    if result.returncode != 0:
        return f"Error opening app: {result.stderr.strip()}"
    return f"App '{package_name}' launched successfully."


if __name__ == "__main__":
    mcp.run()