uiautomator2-mcp-server 0.1.2__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.
- u2mcp/.gitignore +1 -1
- u2mcp/__init__.py +2 -2
- u2mcp/__main__.py +82 -82
- u2mcp/_version.py +34 -34
- u2mcp/mcp.py +79 -61
- u2mcp/tools/__init__.py +4 -3
- u2mcp/tools/action.py +169 -169
- u2mcp/tools/app.py +232 -231
- u2mcp/tools/device.py +259 -293
- u2mcp/tools/misc.py +17 -0
- {uiautomator2_mcp_server-0.1.2.dist-info → uiautomator2_mcp_server-0.1.3.dist-info}/METADATA +115 -113
- uiautomator2_mcp_server-0.1.3.dist-info/RECORD +17 -0
- {uiautomator2_mcp_server-0.1.2.dist-info → uiautomator2_mcp_server-0.1.3.dist-info}/WHEEL +1 -1
- {uiautomator2_mcp_server-0.1.2.dist-info → uiautomator2_mcp_server-0.1.3.dist-info}/licenses/LICENSE +620 -620
- uiautomator2_mcp_server-0.1.2.dist-info/RECORD +0 -16
- {uiautomator2_mcp_server-0.1.2.dist-info → uiautomator2_mcp_server-0.1.3.dist-info}/entry_points.txt +0 -0
- {uiautomator2_mcp_server-0.1.2.dist-info → uiautomator2_mcp_server-0.1.3.dist-info}/top_level.txt +0 -0
{uiautomator2_mcp_server-0.1.2.dist-info → uiautomator2_mcp_server-0.1.3.dist-info}/METADATA
RENAMED
|
@@ -1,113 +1,115 @@
|
|
|
1
|
-
Metadata-Version: 2.4
|
|
2
|
-
Name: uiautomator2-mcp-server
|
|
3
|
-
Version: 0.1.
|
|
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:
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
[](https://github.com/tanbro/uiautomator2-mcp-server)
|
|
30
|
+
[](https://pypi.org/project/uiautomator2-mcp-server/)
|
|
31
|
+
[](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).
|
|
@@ -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,,
|