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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (17) hide show
  1. u2mcp/.gitignore +1 -1
  2. u2mcp/__init__.py +2 -2
  3. u2mcp/__main__.py +82 -60
  4. u2mcp/_version.py +34 -34
  5. u2mcp/mcp.py +79 -18
  6. u2mcp/tools/__init__.py +4 -3
  7. u2mcp/tools/action.py +169 -169
  8. u2mcp/tools/app.py +232 -231
  9. u2mcp/tools/device.py +259 -292
  10. u2mcp/tools/misc.py +17 -0
  11. {uiautomator2_mcp_server-0.1.1.dist-info → uiautomator2_mcp_server-0.1.3.dist-info}/METADATA +115 -106
  12. uiautomator2_mcp_server-0.1.3.dist-info/RECORD +17 -0
  13. {uiautomator2_mcp_server-0.1.1.dist-info → uiautomator2_mcp_server-0.1.3.dist-info}/WHEEL +1 -1
  14. {uiautomator2_mcp_server-0.1.1.dist-info → uiautomator2_mcp_server-0.1.3.dist-info}/licenses/LICENSE +620 -620
  15. uiautomator2_mcp_server-0.1.1.dist-info/RECORD +0 -16
  16. {uiautomator2_mcp_server-0.1.1.dist-info → uiautomator2_mcp_server-0.1.3.dist-info}/entry_points.txt +0 -0
  17. {uiautomator2_mcp_server-0.1.1.dist-info → uiautomator2_mcp_server-0.1.3.dist-info}/top_level.txt +0 -0
{uiautomator2_mcp_server-0.1.1.dist-info → uiautomator2_mcp_server-0.1.3.dist-info}/METADATA RENAMED
@@ -1,106 +1,115 @@
1
- Metadata-Version: 2.4
2
- Name: uiautomator2-mcp-server
3
- Version: 0.1.1
4
- Summary: uiautomator2 mcp server
5
- Author: tanbro
6
- License: GPL-3.0-or-later
7
- Project-URL: homepage, https://github.com/tanbro/uiautomator2-mcp-server
8
- Project-URL: documentation, https://github.com/tanbro/uiautomator2-mcp-server/blob/main/README.md
9
- Project-URL: repository, https://github.com/tanbro/uiautomator2-mcp-server.git
10
- Project-URL: issues, https://github.com/tanbro/uiautomator2-mcp-server/issues
11
- Project-URL: changelog, https://github.com/tanbro/uiautomator2-mcp-server/blob/main/CHANGELOG.md
12
- Requires-Python: >=3.11
13
- Description-Content-Type: text/markdown
14
- License-File: LICENSE
15
- Requires-Dist: fastmcp<3.0,>=2.10
16
- Requires-Dist: uiautomator2<4.0,>=3.5
17
- Dynamic: license-file
18
-
19
- # uiautomator2-mcp-server
20
-
21
- ![GitHub Tag](https://img.shields.io/github/v/tag/tanbro/uiautomator2-mcp-server)
22
- ![PyPI - Version](https://img.shields.io/pypi/v/uiautomator2-mcp-server)
23
-
24
- 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.
25
-
26
- ## Features
27
-
28
- - **Device Management**: List connected devices, initialize devices, connect/disconnect from devices
29
- - **Screen Operations**: Take screenshots, get device window size, dump UI hierarchy
30
- - **Touch Actions**: Click, long click, double click at specific coordinates
31
- - **Gesture Controls**: Swipe, swipe through multiple points, drag operations
32
- - **System Controls**: Screen on/off, key presses
33
- - **App Management**: Install, uninstall, start, stop, clear, and manage Android applications
34
- - **Text Operations**: Send text input, clear text fields
35
-
36
- ## Requirements
37
-
38
- - Python >= 3.11
39
- - Android device with ADB access
40
- - Android device with uiautomator2 resources installed
41
-
42
- ## Installation
43
-
44
- ```bash
45
- # Install the package
46
- pip install uiautomator2-mcp-server
47
- ```
48
-
49
- ## Usage
50
-
51
- ### Running the Server
52
-
53
- The server can be run in different transport modes:
54
-
55
- ```bash
56
- # Run in streamable HTTP mode
57
- u2mcp --http --host 0.0.0.0 --port 8000
58
-
59
- # Run in stdio mode
60
- u2mcp --stdio
61
- ```
62
-
63
- ### Using the Tools
64
-
65
- Connect it to any tool that supports MCP protocol.
66
-
67
- ## Available Tools
68
-
69
- ### Device Management
70
- - `device_list`: Get list of connected devices
71
- - `init`: Install essential resources to device
72
- - `connect`, `disconnect`, `disconnect_all`: Manage device connections
73
- - `info`: Get device information
74
- - `window_size`: Get device window size
75
- - `screenshot`: Take device screenshot
76
- - `dump_hierarchy`: Get UI hierarchy of device
77
-
78
- ### Action Tools
79
- - `click`: Click at specific coordinates
80
- - `long_click`: Long click at specific coordinates
81
- - `double_click`: Double click at specific coordinates
82
- - `swipe`: Swipe from one point to another
83
- - `swipe_points`: Swipe through multiple points
84
- - `drag`: Drag from one point to another
85
- - `press_key`: Press device key
86
- - `send_text`: Send text to device
87
- - `clear_text`: Clear text input
88
- - `screen_on`/`screen_off`: Control screen state
89
-
90
- ### App Management
91
- - `app_install`: Install an app
92
- - `app_uninstall`: Uninstall an app
93
- - `app_uninstall_all`: Uninstall all apps
94
- - `app_start`: Start an app
95
- - `app_stop`: Stop an app
96
- - `app_stop_all`: Stop all apps
97
- - `app_clear`: Clear app data
98
- - `app_info`: Get app information
99
- - `app_current`: Get current app
100
- - `app_list`: List installed apps
101
- - `app_list_running`: List running apps
102
- - `app_auto_grant_permissions`: Auto grant permissions
103
-
104
- ## License
105
-
106
- This project is licensed under the GNU General Public License v3.0 (GPL-3.0).
1
+ Metadata-Version: 2.4
2
+ Name: uiautomator2-mcp-server
3
+ Version: 0.1.3
4
+ Summary: uiautomator2 mcp server
5
+ Author-email: tanbro <tanbro@163.com>
6
+ License-Expression: GPL-3.0-or-later
7
+ Project-URL: homepage, https://github.com/tanbro/uiautomator2-mcp-server
8
+ Project-URL: documentation, https://github.com/tanbro/uiautomator2-mcp-server/blob/main/README.md
9
+ Project-URL: repository, https://github.com/tanbro/uiautomator2-mcp-server.git
10
+ Project-URL: issues, https://github.com/tanbro/uiautomator2-mcp-server/issues
11
+ Project-URL: changelog, https://github.com/tanbro/uiautomator2-mcp-server/blob/main/CHANGELOG.md
12
+ Keywords: uiautomator2,mcp,fastmcp,adb,android,adbutils
13
+ Classifier: Development Status :: 4 - Beta
14
+ Classifier: Programming Language :: Python :: 3
15
+ Classifier: Programming Language :: Python :: 3.11
16
+ Classifier: Programming Language :: Python :: 3.12
17
+ Classifier: Programming Language :: Python :: 3.13
18
+ Classifier: Programming Language :: Python :: 3.14
19
+ Requires-Python: >=3.11
20
+ Description-Content-Type: text/markdown
21
+ License-File: LICENSE
22
+ Requires-Dist: fastmcp<3.0,>=2.11.0
23
+ Requires-Dist: typing_extensions>=4.12.0; python_version < "3.12"
24
+ Requires-Dist: uiautomator2<4.0,>=3.5
25
+ Dynamic: license-file
26
+
27
+ # uiautomator2-mcp-server
28
+
29
+ [![GitHub Tag](https://img.shields.io/github/v/tag/tanbro/uiautomator2-mcp-server)](https://github.com/tanbro/uiautomator2-mcp-server)
30
+ [![PyPI - Version](https://img.shields.io/pypi/v/uiautomator2-mcp-server)](https://pypi.org/project/uiautomator2-mcp-server/)
31
+ [![codecov](https://codecov.io/gh/tanbro/uiautomator2-mcp-server/graph/badge.svg?token=OpQb2Mk6PP)](https://codecov.io/gh/tanbro/uiautomator2-mcp-server)
32
+
33
+ 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.
34
+
35
+ ## Features
36
+
37
+ - **Device Management**: List connected devices, initialize devices, connect/disconnect from devices
38
+ - **Screen Operations**: Take screenshots, get device window size, dump UI hierarchy
39
+ - **Touch Actions**: Click, long click, double click at specific coordinates
40
+ - **Gesture Controls**: Swipe, swipe through multiple points, drag operations
41
+ - **System Controls**: Screen on/off, key presses
42
+ - **App Management**: Install, uninstall, start, stop, clear, and manage Android applications
43
+ - **Text Operations**: Send text input, clear text fields
44
+
45
+ ## Requirements
46
+
47
+ - Python >= 3.11
48
+ - adb executable in your PATH
49
+ - Android device connected in debug mode
50
+
51
+ ## Installation
52
+
53
+ ```bash
54
+ # Install the package
55
+ pip install uiautomator2-mcp-server
56
+ ```
57
+
58
+ ## Usage
59
+
60
+ ### Running the Server
61
+
62
+ The server can be run in different transport modes:
63
+
64
+ ```bash
65
+ # Run in streamable HTTP mode
66
+ u2mcp --host 0.0.0.0 --port 8000 --no-token http
67
+
68
+ # Run in stdio mode
69
+ u2mcp stdio
70
+ ```
71
+
72
+ ### Using the Tools
73
+
74
+ Connect it to any tool that supports MCP protocol.
75
+
76
+ ## Available Tools
77
+
78
+ ### Device Management
79
+ - `device_list`: Get list of connected devices
80
+ - `init`: Install essential resources to device
81
+ - `connect`, `disconnect`, `disconnect_all`: Manage device connections
82
+ - `info`: Get device information
83
+ - `window_size`: Get device window size
84
+ - `screenshot`: Take device screenshot
85
+ - `dump_hierarchy`: Get UI hierarchy of device
86
+
87
+ ### Action Tools
88
+ - `click`: Click at specific coordinates
89
+ - `long_click`: Long click at specific coordinates
90
+ - `double_click`: Double click at specific coordinates
91
+ - `swipe`: Swipe from one point to another
92
+ - `swipe_points`: Swipe through multiple points
93
+ - `drag`: Drag from one point to another
94
+ - `press_key`: Press device key
95
+ - `send_text`: Send text to device
96
+ - `clear_text`: Clear text input
97
+ - `screen_on`/`screen_off`: Control screen state
98
+
99
+ ### App Management
100
+ - `app_install`: Install an app
101
+ - `app_uninstall`: Uninstall an app
102
+ - `app_uninstall_all`: Uninstall all apps
103
+ - `app_start`: Start an app
104
+ - `app_stop`: Stop an app
105
+ - `app_stop_all`: Stop all apps
106
+ - `app_clear`: Clear app data
107
+ - `app_info`: Get app information
108
+ - `app_current`: Get current app
109
+ - `app_list`: List installed apps
110
+ - `app_list_running`: List running apps
111
+ - `app_auto_grant_permissions`: Auto grant permissions
112
+
113
+ ## License
114
+
115
+ This project is licensed under the GNU General Public License v3.0 (GPL-3.0).
uiautomator2_mcp_server-0.1.3.dist-info/RECORD ADDED
@@ -0,0 +1,17 @@
1
+ u2mcp/.gitignore,sha256=tWvEr3sBkY2ODntRp4_IUz3cidH-xu1efiOQK9DfK04,12
2
+ u2mcp/__init__.py,sha256=D-ZK4rYW6cX8a3e2TE5BHt9UXsluqVDO1AYTysieAEU,102
3
+ u2mcp/__main__.py,sha256=TIY4uDd5MtyMDFBgPCB5nFjmYyveJrAN8Tu-Tuf1DYM,2716
4
+ u2mcp/_version.py,sha256=q5nF98G8SoVeJqaknL0xdyxtv0egsqb0fK06_84Izu8,704
5
+ u2mcp/mcp.py,sha256=ZqF2GuFkFdKTxThvDDrtM6-3QpREZ9vOloFRS2nnF4g,2418
6
+ u2mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
7
+ u2mcp/tools/__init__.py,sha256=CgTY_aYNRa1Sy7iJYFdT6ofa2NX_BnfB8AuZkdprZbY,83
8
+ u2mcp/tools/action.py,sha256=A3Se7XWKXIjM9tNzvoVU3uMJSxrFoAqqyt3Neq9tAyM,4943
9
+ u2mcp/tools/app.py,sha256=jT92i0XVvZrjl4WkrIZJBL0wsSGoeY8LtpWo4f67-qA,6605
10
+ u2mcp/tools/device.py,sha256=1sP9XqloL4ioCieOAjgqB3tibxF2hgdmWQ0Ni-K-Gf0,8004
11
+ u2mcp/tools/misc.py,sha256=RgoZVkAp7wqzD2MAQQkronVJEMh9j5-tZQ4iEKabzfg,291
12
+ uiautomator2_mcp_server-0.1.3.dist-info/licenses/LICENSE,sha256=If0-03pAECpKPPFzkXdXEbO8k_I75161r-jP5aGYAec,32502
13
+ uiautomator2_mcp_server-0.1.3.dist-info/METADATA,sha256=l0HTdj9tsSnjlCV4tpYWiFSYPhCIbD6m1DAnzvRDkhY,4358
14
+ uiautomator2_mcp_server-0.1.3.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
15
+ uiautomator2_mcp_server-0.1.3.dist-info/entry_points.txt,sha256=y7lg94G2U5_VgrDtyY8-Ne4ZClFtHo6eAs3RnShuDSI,92
16
+ uiautomator2_mcp_server-0.1.3.dist-info/top_level.txt,sha256=elTNF05b2GS8jjS4Haa3ESnG6xbfRjpyoSRsivT0Uks,6
17
+ uiautomator2_mcp_server-0.1.3.dist-info/RECORD,,
{uiautomator2_mcp_server-0.1.1.dist-info → uiautomator2_mcp_server-0.1.3.dist-info}/WHEEL RENAMED
@@ -1,5 +1,5 @@
1
1
  Wheel-Version: 1.0
2
- Generator: setuptools (80.9.0)
2
+ Generator: setuptools (80.10.1)
3
3
  Root-Is-Purelib: true
4
4
  Tag: py3-none-any
5
5