minitap-mcp 0.4.2__py3-none-any.whl → 0.4.3__py3-none-any.whl

{minitap_mcp-0.4.2.dist-info → minitap_mcp-0.4.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: minitap-mcp
-Version: 0.4.2
+Version: 0.4.3
 Summary: Model Context Protocol server for controlling Android & iOS devices with natural language
 Author: Pierre-Louis Favreau, Jean-Pierre Lo, Clément Guiguet
 Requires-Dist: fastmcp>=2.12.4
@@ -84,11 +84,18 @@ minitap-mcp --server
 
 CLI flags always override environment variables when both are present.
 
-By default, the server will bind to `0.0.0.0:8000`. Configure via environment variables:
+By default, the server will bind to `0.0.0.0:8000`. You can customize the port:
 
 ```bash
+# Using CLI argument
+minitap-mcp --server --port 9000
+
+# Or using environment variable
+export MCP_SERVER_PORT="9000"
+minitap-mcp --server
+
+# You can also customize the host
 export MCP_SERVER_HOST="0.0.0.0"
-export MCP_SERVER_PORT="8000"
 ```
 
 ## IDE Integration
@@ -120,41 +127,122 @@ export MCP_SERVER_PORT="8000"
 ```
 
 
-## Available Tools
+## Available Resources & Tools
+
+Once connected, your AI assistant can use these resources and tools:
+
+### Resource: `data://devices`
+
+Lists all connected mobile devices (Android and iOS).
 
-Once connected, your AI assistant can use these tools:
+**Returns:** Array of device information objects with:
 
-### `execute_mobile_command`
-Execute natural language commands on your mobile device using the Minitap SDK. This tool allows you to control your Android or iOS device using natural language.
+- `device_id`: Device serial (Android) or UDID (iOS)
+- `platform`: `"android"` or `"ios"`
+- `name`: Device name
+- `state`: Device state (`"connected"` or `"Booted"`)
+
+### Tool: `analyze_screen`
+
+Captures a screenshot from a mobile device and analyzes it using a vision language model.
 
 **Parameters:**
-- `goal` (required): High-level goal describing the action to perform
-- `output_description` (optional): Natural language description of the desired output format. Results are returned as structured JSON (e.g., "An array with sender and subject for each email")
-- `profile` (optional): Profile name to use (defaults to "default")
 
-**Examples:**
+- `prompt` (required): Analysis prompt describing what information to extract
+- `device_id` (optional): Specific device ID to target. If not provided, uses the first available device.
+
+**Returns:** AI-generated analysis of the screenshot based on the prompt.
+
+**Example:**
+
 ```
-"Open the settings app and tell me the battery level"
-"Find the first 3 unread emails in Gmail"
-"Open Google Maps and search for the nearest coffee shop"
-"Take a screenshot and save it"
+Prompt: "What app is currently open? List all visible UI elements."
 ```
 
-### `analyze_screen`
-Capture and analyze what's currently shown on the mobile device screen using a vision-capable LLM. Useful for understanding UI elements, extracting text, or identifying specific features.
+The tool will:
+
+1. Find the specified device (or first available)
+2. Capture a screenshot
+3. Analyze it with the vision model
+4. Return the analysis
+
+### Tool: `execute_mobile_command`
+
+Execute natural language commands on your mobile device using the mobile-use SDK. This tool allows you to control your Android or iOS device with simple instructions.
 
 **Parameters:**
-- `prompt` (required): Analysis prompt describing what information to extract
-- `device_id` (optional): Specific device ID to target
+
+- `goal` (required): Natural language command to execute on the device
+- `output_description` (optional): Description of the expected output format (e.g., "A JSON list of objects with sender and subject keys")
+- `profile` (optional): Name of the profile to use for this task. Defaults to 'default'
+
+**Returns:** Execution result with status, output, and any extracted data.
 
 **Examples:**
-```js
-"What app is currently open?"
-"Read the text messages visible on screen"
-"List all buttons and their labels on the current screen"
-"Extract the phone number displayed"
+
+```python
+# Simple command
+goal: "Go to settings and tell me my current battery level"
+
+# Data extraction with structured output
+goal: "Open Gmail, find first 3 unread emails, and list their sender and subject line"
+output_description: "A JSON list of objects, each with 'sender' and 'subject' keys"
+
+# App navigation
+goal: "Open Twitter and scroll to the latest tweet"
 ```
 
+The tool will:
+
+1. Find the specified device (or first available)
+2. Execute the command using the mobile-use AI agent
+3. Return the result or extracted data
+
+### Tool: `save_figma_assets`
+
+Fetch Figma design assets and React implementation code, then save them locally in the workspace.
+
+**Parameters:**
+
+- `node_id` (required): The node ID of the Figma design in format "1:2" (colon-separated). Extract from URLs like `https://figma.com/design/:fileKey/:fileName?node-id=1-2`
+- `file_key` (required): The file key from the Figma URL (e.g., "abc123" from `https://figma.com/design/abc123/MyFile`)
+- `workspace_path` (optional): The workspace path where assets should be saved. Defaults to current directory.
+
+**Returns:** Download summary with list of successfully downloaded assets and any failures.
+
+**Example:**
+
+```python
+node_id: "1:2"
+file_key: "abc123xyz"
+workspace_path: "."
+```
+
+The tool will:
+
+1. Call `get_design_context` from Figma MCP to get React/TypeScript code
+2. Extract all asset URLs from the code implementation
+3. Download each asset to `.mobile-use/figma_assets/<node-id>/` folder
+4. Save the code implementation to `.mobile-use/figma_assets/<node-id>/code_implementation.ts`
+5. Return a list of downloaded files with success/failure status
+
+### Tool: `compare_screenshot_with_figma`
+
+Compare a screenshot of the current mobile device state with a Figma design to identify visual differences.
+
+**Parameters:**
+
+- `node_id` (required): The node ID of the Figma design in format "1:2" (colon-separated). Extract from URLs like `https://figma.com/design/:fileKey/:fileName?node-id=1-2`
+
+**Returns:** Detailed comparison report with both the Figma design and current device screenshots for visual context.
+
+The tool will:
+
+1. Capture a screenshot of the current device state
+2. Fetch the Figma design screenshot
+3. Compare both screenshots using vision AI
+4. Return a detailed analysis highlighting differences
+
 ## Advanced Configuration
 
 ### Custom ADB Server

{minitap_mcp-0.4.2.dist-info → minitap_mcp-0.4.3.dist-info}/RECORD

@@ -19,7 +19,7 @@ minitap/mcp/tools/compare_screenshot_with_figma.py,sha256=G69F6vRFI2tE2wW-oFYPjn
 minitap/mcp/tools/execute_mobile_command.py,sha256=qY3UfcDq1BtYcny1YlEF4WV9LwUJxLAmLJCm1VBzxS8,2442
 minitap/mcp/tools/save_figma_assets.py,sha256=T5a_7wi1aLoyCrn4FWwXEE_m8dXqUu2ZFGDKst_sKHI,9985
 minitap/mcp/tools/screen_analyzer.md,sha256=TTO80JQWusbA9cKAZn-9cqhgVHm6F_qJh5w152hG3YM,734
-minitap_mcp-0.4.2.dist-info/WHEEL,sha256=5w2T7AS2mz1-rW9CNagNYWRCaB0iQqBMYLwKdlgiR4Q,78
-minitap_mcp-0.4.2.dist-info/entry_points.txt,sha256=rYVoXm7tSQCqQTtHx4Lovgn1YsjwtEEHfddKrfEVHuY,55
-minitap_mcp-0.4.2.dist-info/METADATA,sha256=eVB509gMxBsCE-RrIMoj2yNEo7FbADTejwKEcsB6GO0,5918
-minitap_mcp-0.4.2.dist-info/RECORD,,
+minitap_mcp-0.4.3.dist-info/WHEEL,sha256=5w2T7AS2mz1-rW9CNagNYWRCaB0iQqBMYLwKdlgiR4Q,78
+minitap_mcp-0.4.3.dist-info/entry_points.txt,sha256=rYVoXm7tSQCqQTtHx4Lovgn1YsjwtEEHfddKrfEVHuY,55
+minitap_mcp-0.4.3.dist-info/METADATA,sha256=-3t9Ox1LrXQfWtYQRyar6Bneyp_T1FQkBV0djX1lJBY,8641
+minitap_mcp-0.4.3.dist-info/RECORD,,