androidviewclient 25.0.0__tar.gz → 25.0.1__tar.gz

{androidviewclient-25.0.0/src/androidviewclient.egg-info → androidviewclient-25.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: androidviewclient
-Version: 25.0.0
+Version: 25.0.1
 Summary: AndroidViewClient is a 100% pure python library and tools
 Home-page: https://github.com/dtmilano/AndroidViewClient/
 Author: Diego Torres Milano
@@ -21,7 +21,7 @@ Requires-Dist: requests
 Requires-Dist: numpy
 Requires-Dist: matplotlib
 Requires-Dist: culebratester-client>=2.0.73
-Requires-Dist: mcp>=0.9.0
+Requires-Dist: mcp<2,>=0.9.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/README.md

@@ -41,7 +41,7 @@ Or check the wiki for more alternatives.
 
 # AI-Powered Testing with MCP
 
-**NEW!** AndroidViewClient now includes a Model Context Protocol (MCP) server that enables AI assistants like Kiro to interact with Android devices through natural language.
+**NEW!** AndroidViewClient now includes a Model Context Protocol (MCP) server that enables AI assistants like Claude Code and Kiro to interact with Android devices through natural language.
 
 ## Quick Start with MCP
 
@@ -53,11 +53,15 @@ Or check the wiki for more alternatives.
 2. **Start CulebraTester2 on your device:**
    
    Check the details at [How to run CulebraTester2 ?](https://github.com/dtmilano/CulebraTester2-public?tab=readme-ov-file#how-to-run-culebratester2-)
-   
 
-4. **Configure your AI assistant:**
-   
-   Add to `.kiro/settings/mcp.json` or `~/.kiro/settings/mcp.json`:
+3. **Configure your AI assistant:**
+
+   **Claude Code** — register the server with one command:
+   ```bash
+   claude mcp add culebratester2 --env CULEBRATESTER2_URL=http://localhost:9987 -- culebra-mcp
+   ```
+
+   Or add it to `.mcp.json` in your project root, so everyone who clones the project gets it:
    ```json
    {
      "mcpServers": {
@@ -71,12 +75,14 @@ Or check the wiki for more alternatives.
    }
    ```
 
-5. **Start testing with natural language:**
-   - "Get the device screen size"
-   - "Launch the Calculator app"
-   - "Find the button with text Submit and click it"
-   - "Take a screenshot"
-   - "Swipe up to scroll"
+   **Kiro** — add the same entry to `.kiro/settings/mcp.json` or `~/.kiro/settings/mcp.json`.
+
+4. **Start testing with natural language:**
+   - "_Get the device screen size_"
+   - "_Launch the Calculator app_"
+   - "_Find the button with text Submit and click it_"
+   - "_Take a screenshot_"
+   - "_Swipe up to scroll_"
 
 ## MCP Tools Available
 
@@ -103,9 +109,14 @@ The MCP server provides 20 tools for Android automation:
 For detailed MCP configuration options, see the [MCP Configuration Guide](docs/MCP_CONFIGURATION.md).
 
 Quick reference:
-- **User-level config** (kiro-cli): `~/.kiro/settings/mcp.json`
-- **Workspace config** (Kiro IDE): `.kiro/settings/mcp.json`
-- **Examples:** `examples/mcp_config.json`
+
+| | Claude Code | Kiro |
+|---|---|---|
+| **Project config** | `.mcp.json` (repository root) | `.kiro/settings/mcp.json` |
+| **User config** | `~/.claude.json` (via `claude mcp add --scope user`) | `~/.kiro/settings/mcp.json` |
+| **Tool pre-approval** | `permissions.allow` in `.claude/settings.json` | `autoApprove` in the server entry |
+| **Example** | `examples/mcp_config.json` | `examples/mcp_config_kiro.json` |
+
 - **Usage examples:** `examples/test_calculator_mcp.py`
 
 ## Environment Variables

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/setup.py

@@ -3,7 +3,7 @@
 from setuptools import setup, find_packages
 
 setup(name='androidviewclient',
-      version='25.0.0',
+      version='25.0.1',
       description='''AndroidViewClient is a 100% pure python library and tools
         that simplifies test script creation providing higher level
         operations and the ability of obtaining the tree of Views present at
@@ -38,7 +38,9 @@ setup(name='androidviewclient',
           'numpy',
           'matplotlib',
           'culebratester-client >= 2.0.73',
-          'mcp >= 0.9.0',
+          # mcp 2.x renamed FastMCP to MCPServer and changed other APIs;
+          # com.dtmilano.android.mcp.server still uses the v1 API.
+          'mcp >= 0.9.0, < 2',
       ],
       extras_require={
           'dev': [

{androidviewclient-25.0.0 → androidviewclient-25.0.1/src/androidviewclient.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: androidviewclient
-Version: 25.0.0
+Version: 25.0.1
 Summary: AndroidViewClient is a 100% pure python library and tools
 Home-page: https://github.com/dtmilano/AndroidViewClient/
 Author: Diego Torres Milano
@@ -21,7 +21,7 @@ Requires-Dist: requests
 Requires-Dist: numpy
 Requires-Dist: matplotlib
 Requires-Dist: culebratester-client>=2.0.73
-Requires-Dist: mcp>=0.9.0
+Requires-Dist: mcp<2,>=0.9.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/src/androidviewclient.egg-info/requires.txt

@@ -3,7 +3,7 @@ requests
 numpy
 matplotlib
 culebratester-client>=2.0.73
-mcp>=0.9.0
+mcp<2,>=0.9.0
 
 [dev]
 pytest>=7.0.0

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/src/com/dtmilano/android/adb/adbclient.py

@@ -27,7 +27,7 @@ from typing import Optional
 
 from com.dtmilano.android.adb.dumpsys import Dumpsys
 
-__version__ = '25.0.0'
+__version__ = '25.0.1'
 
 import sys
 import warnings

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/src/com/dtmilano/android/adb/dumpsys.py

@@ -23,7 +23,7 @@ import re
 import sys
 from _warnings import warn
 
-__version__ = '25.0.0'
+__version__ = '25.0.1'
 
 DEBUG = False
 

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/src/com/dtmilano/android/code_generator.py

@@ -3,7 +3,7 @@ import textwrap
 from abc import ABC
 from datetime import date
 
-__version__ = '25.0.0'
+__version__ = '25.0.1'
 
 from typing import TextIO, Union, Dict, List
 

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/src/com/dtmilano/android/common.py

@@ -20,7 +20,7 @@ limitations under the License.
 
 from __future__ import print_function
 
-__version__ = '25.0.0'
+__version__ = '25.0.1'
 
 import ast
 import os

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/src/com/dtmilano/android/concertina.py

@@ -22,7 +22,7 @@ import json
 import random
 
 __author__ = 'diego'
-__version__ = '25.0.0'
+__version__ = '25.0.1'
 
 DEBUG = True
 

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/src/com/dtmilano/android/controlpanel.py

@@ -20,7 +20,7 @@
     '''
 import platform
 
-__version__ = '25.0.0'
+__version__ = '25.0.1'
 
 import tkinter
 import tkinter.ttk

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/src/com/dtmilano/android/culebron.py

@@ -38,7 +38,7 @@ from com.dtmilano.android.keyevent import KEY_EVENT
 from com.dtmilano.android.uiautomator.uiautomatorhelper import UiAutomatorHelper
 from com.dtmilano.android.viewclient import ViewClient, View, VERSION_SDK_PROPERTY
 
-__version__ = '25.0.0'
+__version__ = '25.0.1'
 
 import sys
 import threading

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/src/com/dtmilano/android/mcp/__init__.py

@@ -21,7 +21,7 @@ For more information, see:
     https://github.com/dtmilano/AndroidViewClient/
 """
 
-__version__ = '25.0.0'
+__version__ = '25.0.1'
 __author__ = 'Diego Torres Milano'
 __email__ = 'dtmilano@gmail.com'
 

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/src/com/dtmilano/android/mcp/object_store.py

@@ -25,7 +25,7 @@ limitations under the License.
 
 from typing import Dict, Any, Optional
 
-__version__ = '25.0.0'
+__version__ = '25.0.1'
 
 
 class ObjectStore:

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/src/com/dtmilano/android/mcp/server.py

@@ -31,7 +31,7 @@ from culebratester_client import ApiClient, Configuration
 from culebratester_client.api import DefaultApi
 from com.dtmilano.android.mcp.object_store import ObjectStore
 
-__version__ = '25.0.0'
+__version__ = '25.0.1'
 
 # Configure logging
 DEBUG = os.environ.get('CULEBRATESTER2_DEBUG', '').lower() in ('1', 'true', 'yes')

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/src/com/dtmilano/android/plot.py

@@ -31,7 +31,7 @@ from mpl_toolkits.axes_grid1 import host_subplot
 
 from com.dtmilano.android.adb.dumpsys import Dumpsys
 
-__version__ = '25.0.0'
+__version__ = '25.0.1'
 
 DEBUG = False
 

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/src/com/dtmilano/android/robotframework/viewclientwrapper.py

@@ -18,7 +18,7 @@ limitations under the License.
 @author: Diego Torres Milano
 '''
 
-__version__ = '25.0.0'
+__version__ = '25.0.1'
 __author__ = 'diego'
 
 import sys

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/src/com/dtmilano/android/uiautomator/uiautomatorhelper.py

@@ -20,7 +20,7 @@ limitations under the License.
 
 from __future__ import print_function
 
-__version__ = '25.0.0'
+__version__ = '25.0.1'
 
 import math
 import os

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/src/com/dtmilano/android/viewclient.py

@@ -18,15 +18,15 @@ limitations under the License.
 @author: Diego Torres Milano
 """
 
-from __future__ import print_function
+from __future__ import annotations, print_function
 
 import json
-from typing import Optional, Union, Dict, Tuple
+from typing import Literal, Optional, Union, Dict, Tuple
 
 import culebratester_client
 from culebratester_client import WindowHierarchyChild, WindowHierarchy
 
-__version__ = '25.0.0'
+__version__ = '25.0.1'
 
 import sys
 import warnings
@@ -3738,15 +3738,15 @@ class ViewClient:
                 self.windows[int('0x' + wid, 16)] = package
             return self.windows
 
-    def findViewById(self, viewId, root="ROOT", viewFilter=None):
+    def findViewById(self, viewId: str, root: View | Literal["ROOT"] = "ROOT", viewFilter=None) -> View | None:
         """
         Finds the View with the specified viewId.
 
         @type viewId: str
         @param viewId: the ID of the view to find
-        @type root: str
-        @type root: View
-        @param root: the root node of the tree where the View will be searched
+        @type root: View or str
+        @param root: the root node of the tree where the View will be searched, or the
+        string C{"ROOT"} to search the whole tree
         @type: viewFilter: function
         @param viewFilter: a function that will be invoked providing the candidate View as a parameter
         and depending on the return value (C{True} or C{False}) the View will be
@@ -3754,6 +3754,7 @@ class ViewClient:
         This can be C{None} and no extra filtering is applied.
 
         @return: the C{View} found or C{None}
+        @raise ValueError: if C{root} is a str other than C{"ROOT"}
         """
 
         if self.uiAutomatorHelper:
@@ -3763,8 +3764,10 @@ class ViewClient:
         if not root:
             return None
 
-        if root == "ROOT":
-            return self.findViewById(viewId, self.root, viewFilter)
+        if isinstance(root, str):
+            if root == "ROOT":
+                return self.findViewById(viewId, self.root, viewFilter)
+            raise ValueError("Invalid root: '%s', the only str accepted is 'ROOT'" % root)
 
         try:
             rootId = root.getId()
@@ -3806,15 +3809,15 @@ class ViewClient:
                 else:
                     return foundView
 
-    def findViewByIdOrRaise(self, viewId, root="ROOT", viewFilter=None):
+    def findViewByIdOrRaise(self, viewId: str, root: View | Literal["ROOT"] = "ROOT", viewFilter=None) -> View:
         """
         Finds the View or raise a ViewNotFoundException.
 
         @type viewId: str
         @param viewId: the ID of the view to find
-        @type root: str
-        @type root: View
-        @param root: the root node of the tree where the View will be searched
+        @type root: View or str
+        @param root: the root node of the tree where the View will be searched, or the
+        string C{"ROOT"} to search the whole tree
         @type: viewFilter: function
         @param viewFilter: a function that will be invoked providing the candidate View as a parameter
         and depending on the return value (C{True} or C{False}) the View will be
@@ -3822,6 +3825,7 @@ class ViewClient:
         This can be C{None} and no extra filtering is applied.
         @return: the View found
         @raise ViewNotFoundException: raise the exception if View not found
+        @raise ValueError: if C{root} is a str other than C{"ROOT"}
         """
 
         view = self.findViewById(viewId, root, viewFilter)

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/tools/culebra

@@ -28,7 +28,7 @@ from typing import Pattern
 import culebratester_client
 from culebratester_client import WindowHierarchy, Selector
 
-__version__ = '25.0.0'
+__version__ = '25.0.1'
 
 import calendar
 import codecs

{androidviewclient-25.0.0 → androidviewclient-25.0.1}/tools/dump

@@ -8,7 +8,7 @@ Created on Feb 3, 2012
 
 from __future__ import print_function
 
-__version__ = '25.0.0'
+__version__ = '25.0.1'
 
 import getopt
 import os