iflow-mcp_oddlyspaced-android-mcp-py 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

config.py

@@ -0,0 +1,5 @@
+class AndroidMCPConfig:
+    adb_client_host = "127.0.0.1"  # adb server host url
+    adb_client_port = 5037  # adb server host port
+    # serial number or ip of the connected device to use, if this is not present the first available device would be used
+    adb_device_serial = None  # Auto-detect first available device

{iflow_mcp_oddlyspaced_android_mcp_py-0.1.0.dist-info → iflow_mcp_oddlyspaced_android_mcp_py-0.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iflow-mcp_oddlyspaced-android-mcp-py
-Version: 0.1.0
+Version: 0.1.1
 Summary: Ultimate Android MCP - A powerful MCP server for interacting with connected Android devices
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown

iflow_mcp_oddlyspaced_android_mcp_py-0.1.1.dist-info/RECORD

@@ -0,0 +1,18 @@
+config.py,sha256=tQPJyGAK7OU8Q8EtToaPjXOSWsAb9IALMd_02jYRYR8,321
+server.py,sha256=B1L8l9i0MyYYKrU2Urff6rxtQGoS8zfV25qP8OMfGZA,10122
+iflow_mcp_oddlyspaced_android_mcp_py-0.1.1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/device_manager.py,sha256=4ZuXPoKvBXAp367KuPp-zBvhOrty0Csz6XaKlfNU5Nc,3047
+src/handlers/cpu_info_handler.py,sha256=PxUGnsf9mxwNKa0rnPx_vx2b--fGPrc83fwEuTTb0ec,326
+src/handlers/device_info_handler.py,sha256=QWH-0Xp9yDui22H_BDgCy-DsHXwhtVhFiqOHPP2LwQE,756
+src/handlers/file_handler.py,sha256=eKUrv0Q73Umw6Oyc_jBPMqfESh4rkNA3pE-hhkIqbeM,288
+src/handlers/input_handler.py,sha256=BRKZWQqBWjl59_NyeHU7DFfqPDQbQWwgH2QuHL_5aVE,1019
+src/handlers/package_handler.py,sha256=1BOrISSnbws-WbBj7OmUeIEpcvegihjxirTuG9yfo9U,1261
+src/handlers/process_info_handler.py,sha256=y3UKUKpopWQp_VuKPSh9U6q_czQjfy9q8OS2YDuMJP4,522
+src/handlers/shell_handler.py,sha256=vdomnvE6KCJ8Dpu1QpxWl7AjvC0LGLpUsm9Aim67Hqw,196
+src/handlers/ui_handler.py,sha256=Ykhk4SkJkXVsRZsXlKiM7pRPVAD4H1kFro6B6OxIdls,1692
+iflow_mcp_oddlyspaced_android_mcp_py-0.1.1.dist-info/METADATA,sha256=S5ufeaEi0yHjSJdvKE9ghnuzA4ODnJvWxKam_xHHv4U,363
+iflow_mcp_oddlyspaced_android_mcp_py-0.1.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+iflow_mcp_oddlyspaced_android_mcp_py-0.1.1.dist-info/entry_points.txt,sha256=n1QJZSFI2GpcCmmYqxw7NDQZn8Xz9_8-A2EJefGXZmE,81
+iflow_mcp_oddlyspaced_android_mcp_py-0.1.1.dist-info/top_level.txt,sha256=FBTm-QWgq5cJyC42CsL7QXf_v6AfjWkl66AJAFaxsrc,18
+iflow_mcp_oddlyspaced_android_mcp_py-0.1.1.dist-info/RECORD,,

iflow_mcp_oddlyspaced_android_mcp_py-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+android-mcp = iflow_mcp_oddlyspaced_android_mcp_py.server:main

iflow_mcp_oddlyspaced_android_mcp_py-0.1.1.dist-info/top_level.txt

@@ -0,0 +1,3 @@
+config
+server
+src

server.py

@@ -0,0 +1,276 @@
+from mcp.server.fastmcp import FastMCP
+from src.device_manager import DeviceManager
+from config import AndroidMCPConfig
+
+config = AndroidMCPConfig()
+handler = DeviceManager(config)
+
+# Create an MCP server
+mcp = FastMCP("Android MCP")
+
+
+# Tool: Get list of all installed packages
+@mcp.tool()
+def all_packages() -> list[str]:
+    """Returns a list of all packages (both system and user-installed) currently installed on the connected Android device. No parameters are required."""
+    return handler.get_all_packages()
+
+
+# Tool: Get list of all user installed packages
+@mcp.tool()
+def user_packages() -> list[str]:
+    """Returns a list of user-installed application package names on the connected Android device. No parameters are required."""
+    return handler.get_user_packages()
+
+
+# Tool: Get list of all system installed packages
+@mcp.tool()
+def system_packages() -> list[str]:
+    """Returns a list of system application package names (pre-installed apps) on the connected Android device. No parameters are required."""
+    return handler.get_system_packages()
+
+
+# Tool: Launch an app via its package name
+@mcp.tool()
+def launch_app(package_name: str) -> str:
+    """Launches the app with the specified package name on the connected Android device. Requires the `package_name` parameter, which is the package name of the app to be launched."""
+    try:
+        handler.launch_app(package_name)
+        return f"Successfully Launched {package_name}"
+    except:
+        return f"Error Launching {package_name}"
+
+
+# Tool: Get all the visible text label nodes on the screen
+@mcp.tool()
+def get_current_ui_labels() -> list:
+    """Returns a list of UI nodes currently visible on the device screen, focusing on text labels and content descriptions. Each node contains properties like text, bounds, clickable, focusable, and others. No parameters are required."""
+    return handler.get_current_ui_labels()
+
+
+# Tool: Get all the focused nodes
+@mcp.tool()
+def get_current_focused_nodes() -> list:
+    """Returns a list of UI nodes that are currently focused on the connected Android device screen. No parameters are required."""
+    return handler.get_current_focused_nodes()
+
+
+# Tool: Input key event
+@mcp.tool()
+def input_keyevent(keycode: int):
+    """Simulates a key event with the specified keycode on the connected Android device. Requires the `keycode` parameter, which is the keycode of the key to simulate."""
+    return handler.input_keyevent(keycode)
+
+
+# Tool: Back button
+@mcp.tool()
+def input_back():
+    """Simulates a back button event on the connected Android device. No parameters are required."""
+    return handler.input_back()
+
+
+# Tool: Home button
+@mcp.tool()
+def input_home():
+    """Simulates a home button event on the connected Android device. No parameters are required."""
+    return handler.input_home()
+
+
+# Tool: Input tap
+@mcp.tool()
+def input_tap(x: int, y: int):
+    """Simulates a tap gesture at the specified (x, y) coordinates on the connected Android device screen. Requires `x` and `y` parameters, which are the coordinates of the tap."""
+    return handler.input_tap(x, y)
+
+
+# Tool: Input text
+@mcp.tool()
+def input_text(text: str):
+    """Simulates typing the given text input into the currently focused field on the connected Android device. Requires the `text` parameter, which is the string to be typed."""
+    return handler.input_text(text)
+
+
+# Tool: Input press
+@mcp.tool()
+def input_press(keycode: int):
+    """Simulates a key press event with the specified keycode on the connected Android device. Requires the `keycode` parameter, which is the keycode of the key to press."""
+    return handler.input_press(keycode)
+
+
+# Tool: Input roll
+@mcp.tool()
+def input_roll(dx: int, dy: int):
+    """Simulates a rolling gesture with the specified dx and dy values on the connected Android device. Requires `dx` and `dy` parameters, which are the rolling distances in the x and y directions respectively."""
+    return handler.input_roll(dx, dy)
+
+
+# Tool: Input swipe
+@mcp.tool()
+def input_swipe(x1: int, y1: int, x2: int, y2: int, duration_ms: int = None):
+    """Simulates a swipe gesture from (x1, y1) to (x2, y2) with an optional duration on the connected Android device. Requires `x1`, `y1`, `x2`, `y2` parameters for the start and end coordinates, and an optional `duration_ms` parameter for the swipe duration in milliseconds."""
+    return handler.input_swipe(x1, y1, x2, y2, duration_ms)
+
+
+# Tool: Check if keyboard is open
+@mcp.tool()
+def is_keyboard_open():
+    """Checks if the virtual keyboard is currently open on the connected Android device. No parameters are required."""
+    return handler.is_keyboard_open()
+
+
+# Tool: Execute ADB shell command
+@mcp.tool()
+def execute_adb_shell(command: str):
+    """Executes a raw ADB shell command on the connected Android device and returns the output. Requires the `command` parameter, which is the shell command to execute."""
+    return handler.shell(command)
+
+
+# Tool: Get CPU core count
+@mcp.tool()
+def cpu_count():
+    """Returns the number of CPU cores on the connected Android device. No parameters are required."""
+    return handler.cpu_count()
+
+
+# Tool: Get CPU load percentage
+@mcp.tool()
+def cpu_percent():
+    """Returns the current CPU load percentage on the connected Android device. No parameters are required."""
+    return handler.cpu_percent()
+
+
+# Tool: Get device serial number
+@mcp.tool()
+def get_serial_no():
+    """Returns the serial number of the connected Android device. No parameters are required."""
+    return handler.get_serial_no()
+
+
+# Tool: Get device properties
+@mcp.tool()
+def get_properties():
+    """Returns the build.prop properties of the connected Android device. No parameters are required."""
+    return handler.get_properties()
+
+
+# Tool: List device features
+@mcp.tool()
+def list_features():
+    """Returns the device overlay configuration properties of the connected Android device. No parameters are required."""
+    return handler.list_features()
+
+
+# Tool: Get battery level
+@mcp.tool()
+def get_battery_level():
+    """Returns the battery level of the connected Android device. No parameters are required."""
+    return handler.get_battery_level()
+
+
+# Tool: Get screen density
+@mcp.tool()
+def wm_density():
+    """Returns the screen density of the connected Android device. No parameters are required."""
+    return handler.wm_density()
+
+
+# Tool: Get screen size
+@mcp.tool()
+def wm_size():
+    """Returns the screen size of the connected Android device. No parameters are required."""
+    return handler.wm_size()
+
+
+# Tool: Pull file from device
+@mcp.tool()
+def pull_file(remote: str, local: str):
+    """Pulls a file from the connected Android device to the local machine. Requires `remote` and `local` parameters, which are the paths of the file on the device and the local machine respectively."""
+    return handler.pull(remote, local)
+
+
+# Tool: Push file to device
+@mcp.tool()
+def push_file(local: str, remote: str):
+    """Pushes a file from the local machine to the connected Android device. Requires `local` and `remote` parameters, which are the paths of the file on the local machine and the device respectively."""
+    return handler.push(local, remote)
+
+
+# Tool: Get process ID by package name
+@mcp.tool()
+def get_pid(package_name: str):
+    """Returns the process ID (PID) for the specified package name on the connected Android device. Requires the `package_name` parameter, which is the name of the package to query."""
+    return handler.get_pid(package_name)
+
+
+# Tool: Get top activities
+@mcp.tool()
+def get_top_activities():
+    """Returns the activities currently on top on the connected Android device. No parameters are required."""
+    return handler.get_top_activities()
+
+
+# Tool: Get top activity
+@mcp.tool()
+def get_top_activity():
+    """Returns the singular activity currently on top on the connected Android device. No parameters are required."""
+    return handler.get_top_activity()
+
+
+# Tool: Install APK
+@mcp.tool()
+def install_apk(apk_path: str):
+    """Installs an APK on the connected Android device. Requires the `apk_path` parameter, which is the path to the APK file to be installed."""
+    return handler.install(apk_path)
+
+
+# Tool: Uninstall package
+@mcp.tool()
+def uninstall_package(package_name: str):
+    """Uninstalls the specified package from the connected Android device. Requires the `package_name` parameter, which is the name of the package to uninstall."""
+    return handler.uninstall(package_name)
+
+
+# Tool: Check if package is installed
+@mcp.tool()
+def is_installed(package_name: str):
+    """Checks if the specified package is installed on the connected Android device. Requires the `package_name` parameter, which is the name of the package to check."""
+    return handler.is_installed(package_name)
+
+
+# Tool: Get all packages
+@mcp.tool()
+def get_all_packages(
+    user_installed_only: bool = False, system_installed_only: bool = False
+):
+    """Returns a list of all packages on the connected Android device, with optional filters for user-installed or system-installed packages. Accepts `user_installed_only` and `system_installed_only` as optional boolean parameters to filter the results."""
+    return handler.get_all_packages(user_installed_only, system_installed_only)
+
+
+# Tool: Get system packages
+@mcp.tool()
+def get_system_packages():
+    """Returns a list of system-installed packages on the connected Android device. No parameters are required."""
+    return handler.get_system_packages()
+
+
+# Tool: Get user packages
+@mcp.tool()
+def get_user_packages():
+    """Returns a list of user-installed packages on the connected Android device. No parameters are required."""
+    return handler.get_user_packages()
+
+
+# Tool: Launch app
+@mcp.tool()
+def launch_app(package_name: str):
+    """Launches the specified app on the connected Android device. Requires the `package_name` parameter, which is the name of the app to launch."""
+    return handler.launch_app(package_name)
+
+
+if __name__ == "__main__":
+    mcp.run(transport="stdio")
+
+
+def main():
+    """Entry point for uvx and pip install."""
+    mcp.run(transport="stdio")

handlers/cpu_info_handler.py

@@ -1,14 +0,0 @@
-from ppadb.device import Device
-
-
-class CpuInfoHandler:
-    def __init__(self, device: Device):
-        self.device = device
-
-    # returns count of cpu cores
-    def cpu_count(self):
-        return self.device.cpu_count()
-
-    # retuns the current cpu load
-    def cpu_percent(self):
-        return self.device.cpu_percent()

handlers/device_info_handler.py

@@ -1,29 +0,0 @@
-from ppadb.device import Device
-
-
-# device specific information
-class DeviceInfoHandler:
-    def __init__(self, device: Device):
-        self.device = device
-
-    # returns the serial number of the device
-    def get_serial_no(self):
-        return self.device.get_serial_no()
-
-    # returns build.prop properties
-    def get_properties(self):
-        return self.device.get_properties()
-
-    # returns device overlay config properties
-    def list_features(self):
-        return self.device.list_features()
-
-    # returns the device battery level
-    def get_battery_level(self):
-        return self.device.get_battery_level()
-
-    def wm_density(self):
-        return self.device.wm_density()
-
-    def wm_size(self):
-        return self.device.wm_size()

handlers/file_handler.py

@@ -1,12 +0,0 @@
-from ppadb.device import Device
-
-
-class FileHandler:
-    def __init__(self, device: Device):
-        self.device = device
-
-    def pull(self, remote, local):
-        return self.device.pull(remote, local)
-
-    def push(self, local, remote):
-        return self.device.push(local, remote)

handlers/input_handler.py

@@ -1,34 +0,0 @@
-from ppadb.device import Device
-
-
-class InputHandler:
-    def __init__(self, device: Device):
-        self.device = device
-
-    def input_keyevent(self, keycode):
-        return self.device.input_keyevent(keycode)
-
-    def input_back(self):
-        return self.device.input_keyevent("KEYCODE_BACK")
-
-    def input_home(self):
-        return self.device.input_keyevent("KEYCODE_HOME")
-
-    def input_tap(self, x, y):
-        return self.device.input_tap(x, y)
-
-    def input_text(self, text):
-        return self.device.input_text(text)
-
-    def input_press(self, keycode):
-        return self.device.input_press(keycode)
-
-    def input_roll(self, dx, dy):
-        return self.device.input_roll(dx, dy)
-
-    def input_swipe(self, x1, y1, x2, y2, duration_ms=None):
-        return self.device.input_swipe(x1, y1, x2, y2, duration_ms)
-
-    def is_keyboard_open(self) -> bool:
-        # adb shell dumpsys input_method | grep mInputShown
-        return "true" in self.device.shell("dumpsys input_method | grep mInputShown")

handlers/package_handler.py

@@ -1,37 +0,0 @@
-from ppadb.device import Device
-
-
-class PackageHandler:
-    def __init__(self, device: Device):
-        self.device = device
-
-    def install(self, apk_path):
-        return self.device.install(apk_path)
-
-    def uninstall(self, package_name):
-        return self.device.uninstall(package_name)
-
-    def is_installed(self, package_name):
-        return self.device.is_installed(package_name)
-
-    def get_all_packages(
-        self, user_installed_only: bool = False, system_installed_only: bool = False
-    ) -> list[str]:
-        command = "pm list packages"
-        if user_installed_only == True:
-            command += " -3"
-        if system_installed_only == True:
-            command += " -s"
-        return [pkg.strip()[8:] for pkg in self.device.shell(command).splitlines()]
-
-    def get_system_packages(self) -> list[str]:
-        return self.get_all_packages(system_installed_only=True)
-
-    def get_user_packages(self) -> list[str]:
-        return self.get_all_packages(user_installed_only=True)
-
-    def launch_app(self, package_name: str):
-        # adb shell monkey -p com.example.app -c android.intent.category.LAUNCHER 1
-        return self.device.shell(
-            f"monkey -p {package_name} -c android.intent.category.LAUNCHER 1"
-        )

handlers/process_info_handler.py

@@ -1,18 +0,0 @@
-from ppadb.device import Device
-
-
-class ProcessInfoHandler:
-    def __init__(self, device: Device):
-        self.device = device
-
-    # returns the pid for a given package name
-    def get_pid(self, package_name):
-        return self.device.get_pid(package_name)
-
-    # returns the activies currently on top
-    def get_top_activities(self):
-        return self.device.get_top_activities()
-
-    # returns the singular activity currently on top
-    def get_top_activity(self):
-        return self.device.get_top_activity()

handlers/shell_handler.py

@@ -1,9 +0,0 @@
-from ppadb.device import Device
-
-
-class ShellHandler:
-    def __init__(self, device: Device):
-        self.device = device
-
-    def shell(self, command):
-        return self.device.shell(command)

handlers/ui_handler.py

@@ -1,59 +0,0 @@
-from ppadb.device import Device
-import xml.etree.ElementTree as ET
-
-from config import AndroidMCPConfig
-
-
-class UIHandler:
-    def __init__(self, device: Device):
-        self.device = device
-
-    def get_current_ui_labels(self):
-        self.device.shell("uiautomator dump")
-        self.device.pull("/sdcard/window_dump.xml", "window_dump.xml")
-        self.device.shell("rm /sdcard/window_dump.xml")
-
-        tree = ET.parse("window_dump.xml")
-        root = tree.getroot()
-        results = []
-
-        attributes_to_extract = [
-            "text",
-            "bounds",
-            "content-desc",
-            "checkable",
-            "checked",
-            "clickable",
-            "enabled",
-            "focusable",
-            "focused",
-            "long-clickable",
-            "password",
-            "selected",
-            "hint",
-        ]
-
-        for node in root.iter("node"):
-            text = node.attrib.get("text", "").strip()
-            content_desc = node.attrib.get("content-desc", "").strip()
-            if text or content_desc:
-                element = {
-                    attr: node.attrib.get(attr, "") for attr in attributes_to_extract
-                }
-                results.append(element)
-
-        return results
-
-    def get_current_focused_nodes(self):
-        self.device.shell("uiautomator dump")
-        self.device.pull("/sdcard/window_dump.xml", "window_dump.xml")
-        self.device.shell("rm /sdcard/window_dump.xml")
-
-        tree = ET.parse("window_dump.xml")
-        root = tree.getroot()
-
-        for node in root.iter("node"):
-            if node.attrib.get("focused") == "true":
-                return node.attrib
-
-        return None

iflow_mcp_oddlyspaced_android_mcp_py-0.1.0.dist-info/RECORD

@@ -1,24 +0,0 @@
-handlers/cpu_info_handler.py,sha256=PxUGnsf9mxwNKa0rnPx_vx2b--fGPrc83fwEuTTb0ec,326
-handlers/device_info_handler.py,sha256=QWH-0Xp9yDui22H_BDgCy-DsHXwhtVhFiqOHPP2LwQE,756
-handlers/file_handler.py,sha256=eKUrv0Q73Umw6Oyc_jBPMqfESh4rkNA3pE-hhkIqbeM,288
-handlers/input_handler.py,sha256=BRKZWQqBWjl59_NyeHU7DFfqPDQbQWwgH2QuHL_5aVE,1019
-handlers/package_handler.py,sha256=1BOrISSnbws-WbBj7OmUeIEpcvegihjxirTuG9yfo9U,1261
-handlers/process_info_handler.py,sha256=y3UKUKpopWQp_VuKPSh9U6q_czQjfy9q8OS2YDuMJP4,522
-handlers/shell_handler.py,sha256=vdomnvE6KCJ8Dpu1QpxWl7AjvC0LGLpUsm9Aim67Hqw,196
-handlers/ui_handler.py,sha256=Ykhk4SkJkXVsRZsXlKiM7pRPVAD4H1kFro6B6OxIdls,1692
-iflow_mcp_oddlyspaced_android_mcp_py-0.1.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-src/device_manager.py,sha256=4ZuXPoKvBXAp367KuPp-zBvhOrty0Csz6XaKlfNU5Nc,3047
-src/handlers/cpu_info_handler.py,sha256=PxUGnsf9mxwNKa0rnPx_vx2b--fGPrc83fwEuTTb0ec,326
-src/handlers/device_info_handler.py,sha256=QWH-0Xp9yDui22H_BDgCy-DsHXwhtVhFiqOHPP2LwQE,756
-src/handlers/file_handler.py,sha256=eKUrv0Q73Umw6Oyc_jBPMqfESh4rkNA3pE-hhkIqbeM,288
-src/handlers/input_handler.py,sha256=BRKZWQqBWjl59_NyeHU7DFfqPDQbQWwgH2QuHL_5aVE,1019
-src/handlers/package_handler.py,sha256=1BOrISSnbws-WbBj7OmUeIEpcvegihjxirTuG9yfo9U,1261
-src/handlers/process_info_handler.py,sha256=y3UKUKpopWQp_VuKPSh9U6q_czQjfy9q8OS2YDuMJP4,522
-src/handlers/shell_handler.py,sha256=vdomnvE6KCJ8Dpu1QpxWl7AjvC0LGLpUsm9Aim67Hqw,196
-src/handlers/ui_handler.py,sha256=Ykhk4SkJkXVsRZsXlKiM7pRPVAD4H1kFro6B6OxIdls,1692
-iflow_mcp_oddlyspaced_android_mcp_py-0.1.0.dist-info/METADATA,sha256=OIjgHBpNVirdnwp1Q8wfbFwOKh7jMPBOhofJghpILRo,363
-iflow_mcp_oddlyspaced_android_mcp_py-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-iflow_mcp_oddlyspaced_android_mcp_py-0.1.0.dist-info/entry_points.txt,sha256=dOM-FQ2BRw1Th-w41F4mx4TyH75CoLAz3KdRckzzNIY,44
-iflow_mcp_oddlyspaced_android_mcp_py-0.1.0.dist-info/top_level.txt,sha256=frzRIBpXLRa70tNFoHcQEND9oSM-OZSuu0Q37S3fOAs,13
-iflow_mcp_oddlyspaced_android_mcp_py-0.1.0.dist-info/RECORD,,

iflow_mcp_oddlyspaced_android_mcp_py-0.1.0.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-android-mcp = server:main

iflow_mcp_oddlyspaced_android_mcp_py-0.1.0.dist-info/top_level.txt

@@ -1,2 +0,0 @@
-handlers
-src