minitap-mcp 0.5.1__tar.gz → 0.5.2__tar.gz
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.
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/PKG-INFO +9 -3
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/PYPI_README.md +7 -1
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/pyproject.toml +2 -2
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/__init__.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/agents/compare_screenshots/agent.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/agents/compare_screenshots/eval/prompts/prompt_1.md +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/agents/compare_screenshots/eval/scenario_1_add_cartoon_img_and_move_button/actual.png +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/agents/compare_screenshots/eval/scenario_1_add_cartoon_img_and_move_button/figma.png +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/agents/compare_screenshots/eval/scenario_1_add_cartoon_img_and_move_button/human_feedback.txt +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/agents/compare_screenshots/eval/scenario_1_add_cartoon_img_and_move_button/prompt_1/model_params.json +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/agents/compare_screenshots/eval/scenario_1_add_cartoon_img_and_move_button/prompt_1/output.md +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/agents/compare_screenshots/prompt.md +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/config.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/decorators.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/device.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/llm.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/logging_config.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/models.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/sdk_agent.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/utils/figma.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/utils/images.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/main.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/server/middleware.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/server/poller.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/tools/analyze_screen.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/tools/compare_screenshot_with_figma.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/tools/execute_mobile_command.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/tools/save_figma_assets.py +0 -0
- {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/tools/screen_analyzer.md +0 -0
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
Metadata-Version: 2.3
|
|
2
2
|
Name: minitap-mcp
|
|
3
|
-
Version: 0.5.
|
|
3
|
+
Version: 0.5.2
|
|
4
4
|
Summary: Model Context Protocol server for controlling Android & iOS devices with natural language
|
|
5
5
|
Author: Pierre-Louis Favreau, Jean-Pierre Lo, Clément Guiguet
|
|
6
6
|
Requires-Dist: fastmcp>=2.12.4
|
|
7
7
|
Requires-Dist: python-dotenv>=1.1.1
|
|
8
8
|
Requires-Dist: pydantic>=2.12.0
|
|
9
9
|
Requires-Dist: pydantic-settings>=2.10.1
|
|
10
|
-
Requires-Dist: minitap-mobile-use>=2.9.
|
|
10
|
+
Requires-Dist: minitap-mobile-use>=2.9.2
|
|
11
11
|
Requires-Dist: jinja2>=3.1.6
|
|
12
12
|
Requires-Dist: langchain-core>=0.3.75
|
|
13
13
|
Requires-Dist: pillow>=11.1.0
|
|
@@ -38,6 +38,7 @@ pip install minitap-mcp
|
|
|
38
38
|
Before running the MCP server, ensure you have the required mobile automation tools installed:
|
|
39
39
|
|
|
40
40
|
- **For Android devices:**
|
|
41
|
+
|
|
41
42
|
- [ADB (Android Debug Bridge)](https://developer.android.com/tools/adb) - For device communication
|
|
42
43
|
- [Maestro](https://maestro.mobile.dev/) - For mobile automation
|
|
43
44
|
|
|
@@ -126,7 +127,6 @@ export MCP_SERVER_HOST="0.0.0.0"
|
|
|
126
127
|
}
|
|
127
128
|
```
|
|
128
129
|
|
|
129
|
-
|
|
130
130
|
## Available Resources & Tools
|
|
131
131
|
|
|
132
132
|
Once connected, your AI assistant can use these resources and tools:
|
|
@@ -175,6 +175,7 @@ Execute natural language commands on your mobile device using the mobile-use SDK
|
|
|
175
175
|
- `goal` (required): Natural language command to execute on the device
|
|
176
176
|
- `output_description` (optional): Description of the expected output format (e.g., "A JSON list of objects with sender and subject keys")
|
|
177
177
|
- `profile` (optional): Name of the profile to use for this task. Defaults to 'default'
|
|
178
|
+
- `locked_app_package` (optional): Package name of the app to lock the device to. Will launch the app if not already running, and keep it in foreground until the task is completed.
|
|
178
179
|
|
|
179
180
|
**Returns:** Execution result with status, output, and any extracted data.
|
|
180
181
|
|
|
@@ -264,11 +265,13 @@ export VISION_MODEL="qwen/qwen-2.5-vl-7b-instruct"
|
|
|
264
265
|
## Device Setup
|
|
265
266
|
|
|
266
267
|
### Android
|
|
268
|
+
|
|
267
269
|
1. Enable USB debugging on your device
|
|
268
270
|
2. Connect via USB or network ADB
|
|
269
271
|
3. Verify connection: `adb devices`
|
|
270
272
|
|
|
271
273
|
### iOS (macOS only)
|
|
274
|
+
|
|
272
275
|
1. Install Xcode Command Line Tools
|
|
273
276
|
2. Start a simulator or connect a physical device
|
|
274
277
|
3. Verify: `xcrun simctl list devices booted`
|
|
@@ -276,14 +279,17 @@ export VISION_MODEL="qwen/qwen-2.5-vl-7b-instruct"
|
|
|
276
279
|
## Troubleshooting
|
|
277
280
|
|
|
278
281
|
**No devices found:**
|
|
282
|
+
|
|
279
283
|
- Verify ADB/xcrun connection
|
|
280
284
|
- Check USB debugging is enabled (Android)
|
|
281
285
|
- Ensure device is unlocked
|
|
282
286
|
|
|
283
287
|
**Connection refused errors:**
|
|
288
|
+
|
|
284
289
|
- Check ADB/xcrun connection
|
|
285
290
|
|
|
286
291
|
**API authentication errors:**
|
|
292
|
+
|
|
287
293
|
- Verify `MINITAP_API_KEY` is set correctly
|
|
288
294
|
|
|
289
295
|
## Links
|
|
@@ -15,6 +15,7 @@ pip install minitap-mcp
|
|
|
15
15
|
Before running the MCP server, ensure you have the required mobile automation tools installed:
|
|
16
16
|
|
|
17
17
|
- **For Android devices:**
|
|
18
|
+
|
|
18
19
|
- [ADB (Android Debug Bridge)](https://developer.android.com/tools/adb) - For device communication
|
|
19
20
|
- [Maestro](https://maestro.mobile.dev/) - For mobile automation
|
|
20
21
|
|
|
@@ -103,7 +104,6 @@ export MCP_SERVER_HOST="0.0.0.0"
|
|
|
103
104
|
}
|
|
104
105
|
```
|
|
105
106
|
|
|
106
|
-
|
|
107
107
|
## Available Resources & Tools
|
|
108
108
|
|
|
109
109
|
Once connected, your AI assistant can use these resources and tools:
|
|
@@ -152,6 +152,7 @@ Execute natural language commands on your mobile device using the mobile-use SDK
|
|
|
152
152
|
- `goal` (required): Natural language command to execute on the device
|
|
153
153
|
- `output_description` (optional): Description of the expected output format (e.g., "A JSON list of objects with sender and subject keys")
|
|
154
154
|
- `profile` (optional): Name of the profile to use for this task. Defaults to 'default'
|
|
155
|
+
- `locked_app_package` (optional): Package name of the app to lock the device to. Will launch the app if not already running, and keep it in foreground until the task is completed.
|
|
155
156
|
|
|
156
157
|
**Returns:** Execution result with status, output, and any extracted data.
|
|
157
158
|
|
|
@@ -241,11 +242,13 @@ export VISION_MODEL="qwen/qwen-2.5-vl-7b-instruct"
|
|
|
241
242
|
## Device Setup
|
|
242
243
|
|
|
243
244
|
### Android
|
|
245
|
+
|
|
244
246
|
1. Enable USB debugging on your device
|
|
245
247
|
2. Connect via USB or network ADB
|
|
246
248
|
3. Verify connection: `adb devices`
|
|
247
249
|
|
|
248
250
|
### iOS (macOS only)
|
|
251
|
+
|
|
249
252
|
1. Install Xcode Command Line Tools
|
|
250
253
|
2. Start a simulator or connect a physical device
|
|
251
254
|
3. Verify: `xcrun simctl list devices booted`
|
|
@@ -253,14 +256,17 @@ export VISION_MODEL="qwen/qwen-2.5-vl-7b-instruct"
|
|
|
253
256
|
## Troubleshooting
|
|
254
257
|
|
|
255
258
|
**No devices found:**
|
|
259
|
+
|
|
256
260
|
- Verify ADB/xcrun connection
|
|
257
261
|
- Check USB debugging is enabled (Android)
|
|
258
262
|
- Ensure device is unlocked
|
|
259
263
|
|
|
260
264
|
**Connection refused errors:**
|
|
265
|
+
|
|
261
266
|
- Check ADB/xcrun connection
|
|
262
267
|
|
|
263
268
|
**API authentication errors:**
|
|
269
|
+
|
|
264
270
|
- Verify `MINITAP_API_KEY` is set correctly
|
|
265
271
|
|
|
266
272
|
## Links
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
[project]
|
|
2
2
|
name = "minitap-mcp"
|
|
3
|
-
version = "0.5.
|
|
3
|
+
version = "0.5.2"
|
|
4
4
|
description = "Model Context Protocol server for controlling Android & iOS devices with natural language"
|
|
5
5
|
readme = "PYPI_README.md"
|
|
6
6
|
|
|
@@ -17,7 +17,7 @@ dependencies = [
|
|
|
17
17
|
"python-dotenv>=1.1.1",
|
|
18
18
|
"pydantic>=2.12.0",
|
|
19
19
|
"pydantic-settings>=2.10.1",
|
|
20
|
-
"minitap-mobile-use>=2.9.
|
|
20
|
+
"minitap-mobile-use>=2.9.2",
|
|
21
21
|
"jinja2>=3.1.6",
|
|
22
22
|
"langchain-core>=0.3.75",
|
|
23
23
|
"pillow>=11.1.0",
|
|
File without changes
|
{minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/agents/compare_screenshots/agent.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/agents/compare_screenshots/prompt.md
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|