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.
Files changed (29) hide show
  1. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/PKG-INFO +9 -3
  2. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/PYPI_README.md +7 -1
  3. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/pyproject.toml +2 -2
  4. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/__init__.py +0 -0
  5. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/agents/compare_screenshots/agent.py +0 -0
  6. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/agents/compare_screenshots/eval/prompts/prompt_1.md +0 -0
  7. {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
  8. {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
  9. {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
  10. {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
  11. {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
  12. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/agents/compare_screenshots/prompt.md +0 -0
  13. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/config.py +0 -0
  14. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/decorators.py +0 -0
  15. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/device.py +0 -0
  16. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/llm.py +0 -0
  17. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/logging_config.py +0 -0
  18. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/models.py +0 -0
  19. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/sdk_agent.py +0 -0
  20. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/utils/figma.py +0 -0
  21. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/core/utils/images.py +0 -0
  22. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/main.py +0 -0
  23. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/server/middleware.py +0 -0
  24. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/server/poller.py +0 -0
  25. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/tools/analyze_screen.py +0 -0
  26. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/tools/compare_screenshot_with_figma.py +0 -0
  27. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/tools/execute_mobile_command.py +0 -0
  28. {minitap_mcp-0.5.1 → minitap_mcp-0.5.2}/minitap/mcp/tools/save_figma_assets.py +0 -0
  29. {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.1
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.1
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.1"
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.1",
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",