kl-mcp-client 2.1.0__py3-none-any.whl → 2.1.2__py3-none-any.whl

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/asyncio/tools.py

@@ -272,3 +272,50 @@ class MCPTools:
             },
         )
         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/tools.py

@@ -126,27 +126,63 @@ class MCPTools:
 
     @_ensure_client
     def upload_file(
-        self, sessionId: str, selector: str, filename: str, base64data: str
+        self,
+        sessionId: str,
+        selector: str,
+        file_path: str,
     ) -> Dict[str, Any]:
         """
-        Upload file vào input[type=file]
+        Upload file (kể cả video lớn) vào input[type=file] theo luồng mới:
+        1. Multipart upload file lên MCP server
+        2. Nhận uploadId
+        3. Gọi MCP tool uploadFile với uploadId
+
         Args:
             sessionId: MCP browser session
             selector: CSS selector, ví dụ 'input[type=file]'
-            filename: tên file trên browser side
-            base64data: dữ liệu base64 (không kèm header)
-        Returns:
-            structured result từ server
+            file_path: đường dẫn file local (video, pdf, doc, ...)
         """
-        return self.client.call_tool(
+
+        if not file_path:
+            return {"ok": False, "error": "file_path is required"}
+
+        # --------------------------------------------------
+        # 1️⃣ Multipart upload file lên MCP server
+        # --------------------------------------------------
+        try:
+            with open(file_path, "rb") as f:
+                resp = self.client.http.post(
+                    "/upload",
+                    files={"file": f},
+                    timeout=300,  # upload file lớn
+                )
+        except Exception as e:
+            return {"ok": False, "error": f"upload http failed: {e}"}
+
+        if resp.status_code != 200:
+            return {
+                "ok": False,
+                "error": f"upload http error {resp.status_code}: {resp.text}",
+            }
+
+        data = resp.json()
+        upload_id = data.get("uploadId")
+        if not upload_id:
+            return {"ok": False, "error": "uploadId not returned from server"}
+
+        # --------------------------------------------------
+        # 2️⃣ Gọi MCP tool uploadFile (PATH MODE)
+        # --------------------------------------------------
+        result = self.client.call_tool(
             "uploadFile",
             {
                 "sessionId": sessionId,
                 "selector": selector,
-                "filename": filename,
-                "data": base64data,
+                "uploadId": upload_id,
             },
-        ).get("structuredContent", {})
+        )
+
+        return result.get("structuredContent", {})
 
     @_ensure_client
     def wait_for_selector(
@@ -229,6 +265,16 @@ class MCPTools:
             {"sessionId": sessionId, "selector": selector, "args": args or {}},
         )
 
+    @_ensure_client
+    def find_element_by_prompt(self, sessionId: str, prompt: str) -> Dict[str, Any]:
+        """
+        Gọi tool findElementByPrompt trên MCP server.
+        Trả về structuredContent gồm: html, nodeId.
+        """
+        return self.client.call_tool(
+            "findElementByPrompt", {"sessionId": sessionId, "prompt": prompt}
+        ).get("structuredContent", {})
+
     # ======================================================
     # AI / CONTENT PARSING
     # ======================================================
@@ -254,65 +300,24 @@ class MCPTools:
                 "prompt": prompt,
             },
         ).get("structuredContent", {})
+
     # ======================================================
-    # MOUSE / PERFORM ACTIONS
+    # CLEAN TEXT / READ MODE
     # ======================================================
     @_ensure_client
-    def perform_click_xy(
-        self,
-        sessionId: str,
-        x: float,
-        y: float,
-    ) -> Dict[str, Any]:
-        """
-        Move mouse smoothly to (x, y) and left click.
+    def get_clean_text(self, sessionId: str) -> Dict[str, Any]:
         """
-        return self.client.call_tool(
-            "perform",
-            {
-                "sessionId": sessionId,
-                "action": "click",
-                "x": float(x),
-                "y": float(y),
-            },
-        ).get("structuredContent", {})
-    @_ensure_client
-    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).
-        """
-        return self.client.call_tool(
-            "perform",
+        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:
             {
-                "sessionId": sessionId,
-                "action": "drag",
-                "from": {"x": float(from_x), "y": float(from_y)},
-                "to": {"x": float(to_x), "y": float(to_y)},
-            },
-        ).get("structuredContent", {})
-    @_ensure_client
-    def perform_hover(
-        self,
-        sessionId: str,
-        x: float,
-        y: float,
-    ) -> Dict[str, Any]:
-        """
-        Move mouse smoothly to (x, y) without clicking.
+              "text": "...",
+              "length": 12345
+            }
         """
         return self.client.call_tool(
-            "perform",
-            {
-                "sessionId": sessionId,
-                "action": "hover",
-                "x": float(x),
-                "y": float(y),
-            },
+            "getCleanText",
+            {"sessionId": sessionId},
         ).get("structuredContent", {})

{kl_mcp_client-2.1.0.dist-info → kl_mcp_client-2.1.2.dist-info}/METADATA

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

kl_mcp_client-2.1.2.dist-info/RECORD

@@ -0,0 +1,11 @@
+kl_mcp_client/__init__.py,sha256=pdJdBcEH5HaRuHSe2B7VUyRgH5ad3u1dDc4euZMDRMY,106
+kl_mcp_client/__version__.py,sha256=CCYQUt19bi0kfo0Q8q8snnwgw_c9F3s6FFxTMsX1yDE,22
+kl_mcp_client/client.py,sha256=ujhRp0zC5GJKnBYziIPMdKZqrhv8K2t6tBAuwYw7q_k,4513
+kl_mcp_client/tools.py,sha256=Jhx4Zs-1GHCgnHTCHjzmN1batgziOo17fJG5FmQf_Nc,11675
+kl_mcp_client/asyncio/__init__.py,sha256=pdJdBcEH5HaRuHSe2B7VUyRgH5ad3u1dDc4euZMDRMY,106
+kl_mcp_client/asyncio/client.py,sha256=5CpPf1YGOTzYfbG1mAK9s-vhKQULjdlSJnhXm3Th-1s,4413
+kl_mcp_client/asyncio/tools.py,sha256=2rXnmVVCgqRyM30ULN-7tCUARwHg9rbuTyrR-p5O4_Y,11055
+kl_mcp_client-2.1.2.dist-info/METADATA,sha256=uiDz9Ql2IzcHfgNbmBPqu0ofjOepdOmDG9-VuxqS6GI,4443
+kl_mcp_client-2.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+kl_mcp_client-2.1.2.dist-info/top_level.txt,sha256=wd_HFFyGjiKavwACuj8Ny0svtVyNsrxCSVU48EkoQ7c,14
+kl_mcp_client-2.1.2.dist-info/RECORD,,

kl_mcp_client-2.1.0.dist-info/RECORD

@@ -1,11 +0,0 @@
-kl_mcp_client/__init__.py,sha256=pdJdBcEH5HaRuHSe2B7VUyRgH5ad3u1dDc4euZMDRMY,106
-kl_mcp_client/__version__.py,sha256=CCYQUt19bi0kfo0Q8q8snnwgw_c9F3s6FFxTMsX1yDE,22
-kl_mcp_client/client.py,sha256=ujhRp0zC5GJKnBYziIPMdKZqrhv8K2t6tBAuwYw7q_k,4513
-kl_mcp_client/tools.py,sha256=5lI8eoAaZQuB__IfcAzgJh_J7VLw--NMO1rqcc9X6Qw,11083
-kl_mcp_client/asyncio/__init__.py,sha256=pdJdBcEH5HaRuHSe2B7VUyRgH5ad3u1dDc4euZMDRMY,106
-kl_mcp_client/asyncio/client.py,sha256=bgooGIzdU-BKAo0f2wHZKkuIHlKrj5GJ8vxAuwU6Xn4,4409
-kl_mcp_client/asyncio/tools.py,sha256=82zwDC_N0spi_DIPbOq6HgG6qxgpBM2PtBkzUZGDxAo,9658
-kl_mcp_client-2.1.0.dist-info/METADATA,sha256=L1ezxu5mRFgD10rsX668ebKhe8dFGmVoIyP2wvzqqo8,4443
-kl_mcp_client-2.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-kl_mcp_client-2.1.0.dist-info/top_level.txt,sha256=wd_HFFyGjiKavwACuj8Ny0svtVyNsrxCSVU48EkoQ7c,14
-kl_mcp_client-2.1.0.dist-info/RECORD,,