kl-mcp-client 2.0.4__tar.gz → 2.1.2__tar.gz

{kl_mcp_client-2.0.4 → kl_mcp_client-2.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kl-mcp-client
-Version: 2.0.4
+Version: 2.1.2
 Summary: MCP Client for Python
 Author-email: Kyle <hngan.it@gmail.com>
 License: MIT

{kl_mcp_client-2.0.4 → kl_mcp_client-2.1.2}/kl_mcp_client/asyncio/client.py

@@ -146,3 +146,4 @@ class MCPClient:
     async def aclose(self):
         """Close the httpx async client"""
         await self._client.aclose()
+    

{kl_mcp_client-2.0.4 → kl_mcp_client-2.1.2}/kl_mcp_client/asyncio/tools.py

@@ -46,7 +46,7 @@ class MCPTools:
 
     async def screenshot(self, sessionId: str) -> Dict[str, Any]:
         """
-        ADK Web expects this structure:
+        ADK Web expects:
         {
             "type": "image",
             "mimeType": "image/png",
@@ -121,7 +121,7 @@ class MCPTools:
     ) -> Dict[str, Any]:
         args = {"sessionId": sessionId, "selector": selector}
         if timeoutMs is not None:
-            args["timeoutMs"] = timeoutMs
+            args["timeoutMs"] = int(timeoutMs)
 
         res = await self.client.call_tool("waitForSelector", args)
         return res.get("structuredContent", {})
@@ -145,10 +145,10 @@ class MCPTools:
         return res.get("structuredContent", {})
 
     # ======================================================
-    # ADVANCED
+    # ADVANCED ACTIONS
     # ======================================================
 
-    async def click_to_text(self, sessionId: str, text: str) -> dict:
+    async def click_to_text(self, sessionId: str, text: str) -> Dict[str, Any]:
         res = await self.client.call_tool(
             "clickToText", {"sessionId": sessionId, "text": text}
         )
@@ -178,25 +178,144 @@ class MCPTools:
         )
         return res.get("structuredContent", {})
 
+    async def get_dom_tree(self, sessionId: str, args: Optional[dict] = None):
+        return await self.client.call_tool(
+            "getDomTree", {"sessionId": sessionId, "args": args or {}}
+        )
+
+    async def get_clickable(self, sessionId: str, args: Optional[dict] = None):
+        return await self.client.call_tool(
+            "getClickable", {"sessionId": sessionId, "args": args or {}}
+        )
+
+    async def selector_map(
+        self, sessionId: str, selector: str, args: Optional[dict] = None
+    ):
+        return await self.client.call_tool(
+            "selectorMap",
+            {"sessionId": sessionId, "selector": selector, "args": args or {}},
+        )
+
+    # ======================================================
+    # AI / CONTENT PARSING
+    # ======================================================
+
     async def parse_html_by_prompt(self, html: str, prompt: str) -> Dict[str, Any]:
+        res = await self.client.call_tool(
+            "parseHTMLByPrompt",
+            {"html": html, "prompt": prompt},
+        )
+        return res.get("structuredContent", {})
+
+    # ======================================================
+    # MOUSE / PERFORM ACTIONS
+    # ======================================================
+
+    async def perform_click_xy(
+        self,
+        sessionId: str,
+        x: float,
+        y: float,
+    ) -> Dict[str, Any]:
         """
-        Parse HTML content using AI with dynamic prompt-defined structure.
+        Move mouse smoothly to (x, y) and left click.
+        """
+        res = await self.client.call_tool(
+            "perform",
+            {
+                "sessionId": sessionId,
+                "action": "click",
+                "x": float(x),
+                "y": float(y),
+            },
+        )
+        return res.get("structuredContent", {})
 
-        Args:
-            html: Raw HTML string (client-provided)
-            prompt: Instruction that defines what to extract and output structure
-                    Example:
-                      - "Hãy lấy nội dung bài viết, struct trả về { content }"
-                      - "Hãy lấy số lượng like, share, comment, trả JSON { like, share, comment }"
+    async def perform_drag(
+        self,
+        sessionId: str,
+        from_x: float,
+        from_y: float,
+        to_x: float,
+        to_y: float,
+    ) -> Dict[str, Any]:
+        """
+        Drag mouse from (from_x, from_y) to (to_x, to_y).
+        """
+        res = await self.client.call_tool(
+            "perform",
+            {
+                "sessionId": sessionId,
+                "action": "drag",
+                "from": {"x": float(from_x), "y": float(from_y)},
+                "to": {"x": float(to_x), "y": float(to_y)},
+            },
+        )
+        return res.get("structuredContent", {})
 
-        Returns:
-            structuredContent (dynamic JSON defined by prompt)
+    async def perform_hover(
+        self,
+        sessionId: str,
+        x: float,
+        y: float,
+    ) -> Dict[str, Any]:
+        """
+        Move mouse smoothly to (x, y) without clicking.
         """
         res = await self.client.call_tool(
-            "parseHTMLByPrompt",
+            "perform",
             {
-                "html": html,
-                "prompt": prompt,
+                "sessionId": sessionId,
+                "action": "hover",
+                "x": float(x),
+                "y": float(y),
             },
         )
         return res.get("structuredContent", {})
+
+    # CLEAN TEXT / READ MODE
+    # ======================================================
+    async def get_clean_text(self, sessionId: str) -> Dict[str, Any]:
+        """
+        Lấy toàn bộ visible text đã được clean trên trang hiện tại.
+        - Bỏ script/style/iframe/svg/canvas
+        - Chỉ text nhìn thấy (display/visibility/opacity)
+
+        Returns:
+            {
+              "text": "...",
+              "length": 12345
+            }
+        """
+        res = await self.client.call_tool(
+            "getCleanText",
+            {"sessionId": sessionId},
+        )
+        return res.get("structuredContent", {})
+
+    # ======================================================
+    # KEYBOARD (ASYNC)
+    # ======================================================
+    async def send_key(
+        self,
+        sessionId: str,
+        key: str,
+    ) -> Dict[str, Any]:
+        """
+        Send a keyboard key to the active page (async).
+
+        Args:
+            sessionId: MCP browser session
+            key: Keyboard key (e.g. "Enter", "Tab", "Escape", "ArrowDown",
+                 "Ctrl+a", "Ctrl+Enter")
+
+        Returns:
+            structuredContent from MCP server
+        """
+        return await self.call_tool_structured(
+            "sendKey",
+            {
+                "sessionId": sessionId,
+                "key": key,
+            },
+        )

{kl_mcp_client-2.0.4 → kl_mcp_client-2.1.2}/kl_mcp_client/tools.py

@@ -300,3 +300,24 @@ class MCPTools:
                 "prompt": prompt,
             },
         ).get("structuredContent", {})
+
+    # ======================================================
+    # CLEAN TEXT / READ MODE
+    # ======================================================
+    @_ensure_client
+    def get_clean_text(self, sessionId: str) -> Dict[str, Any]:
+        """
+        Lấy toàn bộ visible text đã được clean trên trang hiện tại.
+        - Bỏ script/style/iframe/svg/canvas
+        - Chỉ text nhìn thấy (display/visibility/opacity)
+
+        Returns:
+            {
+              "text": "...",
+              "length": 12345
+            }
+        """
+        return self.client.call_tool(
+            "getCleanText",
+            {"sessionId": sessionId},
+        ).get("structuredContent", {})

{kl_mcp_client-2.0.4 → kl_mcp_client-2.1.2}/kl_mcp_client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kl-mcp-client
-Version: 2.0.4
+Version: 2.1.2
 Summary: MCP Client for Python
 Author-email: Kyle <hngan.it@gmail.com>
 License: MIT

{kl_mcp_client-2.0.4 → kl_mcp_client-2.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kl-mcp-client"
-version = "2.0.4"
+version = "2.1.2"
 description = "MCP Client for Python"
 dependencies = [ "requests>=2.32.5", "httpx>=0.28.1",]
 readme = "README.md"