uiautomator2-mcp-server 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

u2mcp/tools/device.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 import asyncio
 import sys
 from base64 import b64encode
+from collections.abc import AsyncGenerator
 from contextlib import asynccontextmanager
 from io import BytesIO
 from typing import Any, Literal
@@ -36,7 +37,7 @@ _device_connect_lock = asyncio.Lock()
 
 
 @asynccontextmanager
-async def get_device(serial: str):
+async def get_device(serial: str) -> AsyncGenerator[u2.Device]:
     async with _device_connect_lock:
         try:
             semaphore, device = _devices[serial]
@@ -156,10 +157,10 @@ async def connect(serial: str = ""):
 
     if serial := serial.strip():
         try:
-            async with get_device(serial) as device:
+            async with get_device(serial) as device_1:
                 # Found, then check if it's still connected
                 try:
-                    return await asyncio.to_thread(lambda: device.device_info | device.info)
+                    return await asyncio.to_thread(lambda: device_1.device_info | device_1.info)
                 except u2.ConnectError as e:
                     # Found, but not connected, delete it
                     logger.warning("Device %s is no longer connected, delete it!", serial)
@@ -172,6 +173,8 @@ async def connect(serial: str = ""):
     # make new connection here!
     async with _device_connect_lock:
         device = await asyncio.to_thread(u2.connect, serial)
+        if device is None:
+            raise RuntimeError("Cannot connect to device")
         logger.info("Connected to device %s", device.serial)
         result = await asyncio.to_thread(lambda: device.device_info | device.info)
         _devices[device.serial] = asyncio.Semaphore(), device
@@ -287,4 +290,3 @@ async def info(serial: str) -> dict[str, Any]:
 
     async with get_device(serial) as device:
         return await asyncio.to_thread(lambda: device.info)
-

uiautomator2_mcp_server-0.1.1.dist-info/METADATA

@@ -0,0 +1,106 @@
+Metadata-Version: 2.4
+Name: uiautomator2-mcp-server
+Version: 0.1.1
+Summary: uiautomator2 mcp server
+Author: tanbro
+License: GPL-3.0-or-later
+Project-URL: homepage, https://github.com/tanbro/uiautomator2-mcp-server
+Project-URL: documentation, https://github.com/tanbro/uiautomator2-mcp-server/blob/main/README.md
+Project-URL: repository, https://github.com/tanbro/uiautomator2-mcp-server.git
+Project-URL: issues, https://github.com/tanbro/uiautomator2-mcp-server/issues
+Project-URL: changelog, https://github.com/tanbro/uiautomator2-mcp-server/blob/main/CHANGELOG.md
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastmcp<3.0,>=2.10
+Requires-Dist: uiautomator2<4.0,>=3.5
+Dynamic: license-file
+
+# uiautomator2-mcp-server
+
+![GitHub Tag](https://img.shields.io/github/v/tag/tanbro/uiautomator2-mcp-server)
+![PyPI - Version](https://img.shields.io/pypi/v/uiautomator2-mcp-server)
+
+A MCP (Model Context Protocol) server that provides tools for controlling and interacting with Android devices using uiautomator2. This server allows you to perform various operations on Android devices such as connecting to devices, taking screenshots, getting device information, accessing UI hierarchy, tap on screens, and more.
+
+## Features
+
+- **Device Management**: List connected devices, initialize devices, connect/disconnect from devices
+- **Screen Operations**: Take screenshots, get device window size, dump UI hierarchy
+- **Touch Actions**: Click, long click, double click at specific coordinates
+- **Gesture Controls**: Swipe, swipe through multiple points, drag operations
+- **System Controls**: Screen on/off, key presses
+- **App Management**: Install, uninstall, start, stop, clear, and manage Android applications
+- **Text Operations**: Send text input, clear text fields
+
+## Requirements
+
+- Python >= 3.11
+- Android device with ADB access
+- Android device with uiautomator2 resources installed
+
+## Installation
+
+```bash
+# Install the package
+pip install uiautomator2-mcp-server
+```
+
+## Usage
+
+### Running the Server
+
+The server can be run in different transport modes:
+
+```bash
+# Run in streamable HTTP mode
+u2mcp --http --host 0.0.0.0 --port 8000
+
+# Run in stdio mode
+u2mcp --stdio
+```
+
+### Using the Tools
+
+Connect it to any tool that supports MCP protocol.
+
+## Available Tools
+
+### Device Management
+- `device_list`: Get list of connected devices
+- `init`: Install essential resources to device
+- `connect`, `disconnect`, `disconnect_all`: Manage device connections
+- `info`: Get device information
+- `window_size`: Get device window size
+- `screenshot`: Take device screenshot
+- `dump_hierarchy`: Get UI hierarchy of device
+
+### Action Tools
+- `click`: Click at specific coordinates
+- `long_click`: Long click at specific coordinates
+- `double_click`: Double click at specific coordinates
+- `swipe`: Swipe from one point to another
+- `swipe_points`: Swipe through multiple points
+- `drag`: Drag from one point to another
+- `press_key`: Press device key
+- `send_text`: Send text to device
+- `clear_text`: Clear text input
+- `screen_on`/`screen_off`: Control screen state
+
+### App Management
+- `app_install`: Install an app
+- `app_uninstall`: Uninstall an app
+- `app_uninstall_all`: Uninstall all apps
+- `app_start`: Start an app
+- `app_stop`: Stop an app
+- `app_stop_all`: Stop all apps
+- `app_clear`: Clear app data
+- `app_info`: Get app information
+- `app_current`: Get current app
+- `app_list`: List installed apps
+- `app_list_running`: List running apps
+- `app_auto_grant_permissions`: Auto grant permissions
+
+## License
+
+This project is licensed under the GNU General Public License v3.0 (GPL-3.0).

uiautomator2_mcp_server-0.1.1.dist-info/RECORD

@@ -0,0 +1,16 @@
+u2mcp/.gitignore,sha256=mr9Izcwvjgv215xjRKhWEZ7vsyrKWhMqvWjSLHRYDjk,13
+u2mcp/__init__.py,sha256=xsioVkbaN9sg-us_kNMeH-DojD8xM-h6Nlhde6uRHCQ,104
+u2mcp/__main__.py,sha256=I5ON-vrBr8rGWblondFcP2HhuQKhDPLn1y40YYjCWng,1943
+u2mcp/_version.py,sha256=qS3Rb8IU851vIlLXMW4dseE1Fx3Ssytyif_1QTy34YM,738
+u2mcp/mcp.py,sha256=JSNkfVviZqeh-Io48STjRuI9jJYcw7eo-o80z6zOSQs,739
+u2mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+u2mcp/tools/__init__.py,sha256=tKfsoF6tYQSapfGC1ybEcU4S77cipyfO5tYR6u0eAlI,66
+u2mcp/tools/action.py,sha256=A9dCED1NiKOJpw9lBewOQ9YQvfGOkK8bEL1L9FLjCQg,5088
+u2mcp/tools/app.py,sha256=b-cOdDtjSKC8KeUK5TTJCPRXtzvwSH74P02Cm3mS-ck,6809
+u2mcp/tools/device.py,sha256=yN1mWMJeIh6cMQA3m5HE3VqAkaIJOyfNIuNgWn-xoSU,9242
+uiautomator2_mcp_server-0.1.1.dist-info/licenses/LICENSE,sha256=ea2KuPdrBJ0Dhw1ncbc7siZDKG4cz2z-_8cSQiu4n1g,33122
+uiautomator2_mcp_server-0.1.1.dist-info/METADATA,sha256=yw6XCj9zVj2jS108gHaCCZtQl3bOptakor8NpYO-tEg,3761
+uiautomator2_mcp_server-0.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+uiautomator2_mcp_server-0.1.1.dist-info/entry_points.txt,sha256=y7lg94G2U5_VgrDtyY8-Ne4ZClFtHo6eAs3RnShuDSI,92
+uiautomator2_mcp_server-0.1.1.dist-info/top_level.txt,sha256=elTNF05b2GS8jjS4Haa3ESnG6xbfRjpyoSRsivT0Uks,6
+uiautomator2_mcp_server-0.1.1.dist-info/RECORD,,

uiautomator2_mcp_server-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

{uiautomator2_mcp_server-0.1.0.dist-info → uiautomator2_mcp_server-0.1.1.dist-info}/entry_points.txt

@@ -1,3 +1,3 @@
 [console_scripts]
 u2mcp = u2mcp.__main__:main
-
+uiautomator2-mcp-server = u2mcp.__main__:main