kl-mcp-client 2.1.0__tar.gz → 2.1.3__tar.gz

{kl_mcp_client-2.1.0 → kl_mcp_client-2.1.3}/PKG-INFO

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

{kl_mcp_client-2.1.0 → kl_mcp_client-2.1.3}/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.1.0 → kl_mcp_client-2.1.3}/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-2.1.0 → kl_mcp_client-2.1.3}/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,125 @@ 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]:
+    def get_clean_text(self, sessionId: str) -> Dict[str, Any]:
         """
-        Move mouse smoothly to (x, y) and left click.
+        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(
-            "perform",
-            {
-                "sessionId": sessionId,
-                "action": "click",
-                "x": float(x),
-                "y": float(y),
-            },
+            "getCleanText",
+            {"sessionId": sessionId},
         ).get("structuredContent", {})
+
     @_ensure_client
-    def perform_drag(
+    def evaluate_stream(
         self,
         sessionId: str,
-        from_x: float,
-        from_y: float,
-        to_x: float,
-        to_y: float,
+        expression: str,
+        chunkSize: int = 100,
     ) -> Dict[str, Any]:
         """
-        Drag mouse from (from_x, from_y) to (to_x, to_y).
+        Evaluate JS expression theo chế độ STREAM.
+        Dùng khi kết quả là array lớn (DOM, list, table, ...)
+
+        Returns (init response):
+        {
+          "stream_id": "...",
+          "total": 1234,
+          "chunk_size": 100
+        }
         """
         return self.client.call_tool(
-            "perform",
+            "evaluate.stream",
             {
                 "sessionId": sessionId,
-                "action": "drag",
-                "from": {"x": float(from_x), "y": float(from_y)},
-                "to": {"x": float(to_x), "y": float(to_y)},
+                "expression": expression,
+                "chunkSize": int(chunkSize),
             },
         ).get("structuredContent", {})
+
     @_ensure_client
-    def perform_hover(
+    def stream_pull(
         self,
-        sessionId: str,
-        x: float,
-        y: float,
+        stream_id: str,
+        offset: int = 0,
+        limit: int = 100,
     ) -> Dict[str, Any]:
         """
-        Move mouse smoothly to (x, y) without clicking.
+        Kéo 1 chunk từ stream đã tạo bởi evaluate.stream
+
+        Returns:
+        {
+          "items": [...],
+          "offset": 0,
+          "has_more": true
+        }
         """
         return self.client.call_tool(
-            "perform",
+            "stream.pull",
             {
-                "sessionId": sessionId,
-                "action": "hover",
-                "x": float(x),
-                "y": float(y),
+                "stream_id": stream_id,
+                "offset": int(offset),
+                "limit": int(limit),
             },
         ).get("structuredContent", {})
+
+    @_ensure_client
+    def evaluate_stream_all(
+        self,
+        sessionId: str,
+        expression: str,
+        chunkSize: int = 100,
+        max_items: Optional[int] = None,
+    ):
+        """
+        Helper: evaluate.stream + tự động pull toàn bộ dữ liệu.
+
+        ⚠️ Chỉ dùng khi bạn THỰC SỰ cần full data.
+        """
+        init = self.evaluate_stream(
+            sessionId=sessionId,
+            expression=expression,
+            chunkSize=chunkSize,
+        )
+
+        stream_id = init.get("stream_id")
+        total = init.get("total", 0)
+
+        if not stream_id:
+            return []
+
+        items = []
+        offset = 0
+
+        while True:
+            chunk = self.stream_pull(
+                stream_id=stream_id,
+                offset=offset,
+                limit=chunkSize,
+            )
+
+            part = chunk.get("items", [])
+            items.extend(part)
+
+            if max_items and len(items) >= max_items:
+                return items[:max_items]
+
+            if not chunk.get("has_more"):
+                break
+
+            offset += chunkSize
+
+        return items

{kl_mcp_client-2.1.0 → kl_mcp_client-2.1.3}/kl_mcp_client.egg-info/PKG-INFO

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

{kl_mcp_client-2.1.0 → kl_mcp_client-2.1.3}/pyproject.toml

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