kl-mcp-client 2.1.8__py3-none-any.whl → 2.1.10__py3-none-any.whl

kl_mcp_client/__version__.py

@@ -1 +1 @@
-__VERSION__ = "2.1.8"
+__VERSION__ = "2.1.10"

kl_mcp_client/asyncio/tools.py

@@ -64,7 +64,8 @@ class MCPTools:
 
     async def type(self, sessionId: str, selector: str, text: str) -> Dict[str, Any]:
         res = await self.client.call_tool(
-            "type", {"sessionId": sessionId, "selector": selector, "text": text}
+            "type", {"sessionId": sessionId,
+                     "selector": selector, "text": text}
         )
         return res.get("structuredContent", {})
 
@@ -319,7 +320,7 @@ class MCPTools:
                 "key": key,
             },
         )
-    
+
     # ======================================================
     # BROWSER RUNTIME (NO SESSION)
     # ======================================================
@@ -341,13 +342,63 @@ class MCPTools:
         )
         return res.get("structuredContent", {})
 
-    async def release_browser(self) -> Dict[str, Any]:
+    async def release_browser(self, pop_name: str) -> Dict[str, Any]:
         """
         Release / stop browser runtime.
         - KHÔNG cần payload
         """
         res = await self.client.call_tool(
             "release_browser",
-            {},
+            {
+                "pod_name": pop_name
+            },
+        )
+        return res.get("structuredContent", {})
+    # ======================================================
+    # VIEWPORT (Playwright-style, ASYNC)
+    # ======================================================
+
+    async def get_viewport(self, sessionId: str) -> Dict[str, Any]:
+        """
+        Get current browser viewport.
+        Equivalent to Playwright page.viewportSize().
+        """
+        res = await self.client.call_tool(
+            "viewport",
+            {
+                "sessionId": sessionId,
+            },
+        )
+        return res.get("structuredContent", {})
+
+    async def set_viewport(
+        self,
+        sessionId: str,
+        *,
+        width: int,
+        height: int,
+        deviceScaleFactor: float = 1.0,
+        mobile: bool = False,
+    ) -> Dict[str, Any]:
+        """
+        Set browser viewport (Playwright-like).
+
+        Args:
+            width: viewport width
+            height: viewport height
+            deviceScaleFactor: default 1.0
+            mobile: mobile emulation flag
+        """
+        res = await self.client.call_tool(
+            "viewport",
+            {
+                "sessionId": sessionId,
+                "viewport": {
+                    "width": int(width),
+                    "height": int(height),
+                    "deviceScaleFactor": float(deviceScaleFactor),
+                    "mobile": bool(mobile),
+                },
+            },
         )
         return res.get("structuredContent", {})

kl_mcp_client/tools.py

@@ -34,7 +34,8 @@ class MCPTools:
     # ======================================================
     def connect_mcp(self, mcpUrl: str) -> Dict[str, Any]:
         # sid = self.client.create_session(mcpUrl)
-        self.client = MCPClient(base_url=mcpUrl, headers=None, timeout=30, retries=2)
+        self.client = MCPClient(
+            base_url=mcpUrl, headers=None, timeout=30, retries=2)
         return {"ok": True, "cdpUrl": "http://localhost:9222"}
 
     @_ensure_client
@@ -88,7 +89,8 @@ class MCPTools:
     @_ensure_client
     def type(self, sessionId: str, selector: str, text: str) -> Dict[str, Any]:
         return self.client.call_tool(
-            "type", {"sessionId": sessionId, "selector": selector, "text": text}
+            "type", {"sessionId": sessionId,
+                     "selector": selector, "text": text}
         ).get("structuredContent", {})
 
     @_ensure_client
@@ -562,6 +564,7 @@ class MCPTools:
         # ======================================================
     # BROWSER RUNTIME (NO SESSION)
     # ======================================================
+
     @_ensure_client
     def create_browser(self, payload: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
         """
@@ -576,12 +579,61 @@ class MCPTools:
         ).get("structuredContent", {})
 
     @_ensure_client
-    def release_browser(self) -> Dict[str, Any]:
+    def release_browser(self, pop_name: str) -> Dict[str, Any]:
         """
         Release / stop browser runtime.
-        Không cần payload.
         """
         return self.client.call_tool(
             "release_browser",
-            {},
+            {
+                "pod_name": pop_name
+            },
+        ).get("structuredContent", {})
+    # ======================================================
+    # VIEWPORT (Playwright-style)
+    # ======================================================
+
+    @_ensure_client
+    def get_viewport(self, sessionId: str) -> Dict[str, Any]:
+        """
+        Get current browser viewport.
+        Equivalent to Playwright page.viewportSize().
+        """
+        return self.client.call_tool(
+            "viewport",
+            {
+                "sessionId": sessionId,
+            },
+        ).get("structuredContent", {})
+
+    @_ensure_client
+    def set_viewport(
+        self,
+        sessionId: str,
+        *,
+        width: int,
+        height: int,
+        deviceScaleFactor: float = 1.0,
+        mobile: bool = False,
+    ) -> Dict[str, Any]:
+        """
+        Set browser viewport (Playwright-like).
+
+        Args:
+            width: viewport width
+            height: viewport height
+            deviceScaleFactor: default 1.0
+            mobile: mobile emulation flag
+        """
+        return self.client.call_tool(
+            "viewport",
+            {
+                "sessionId": sessionId,
+                "viewport": {
+                    "width": int(width),
+                    "height": int(height),
+                    "deviceScaleFactor": float(deviceScaleFactor),
+                    "mobile": bool(mobile),
+                },
+            },
         ).get("structuredContent", {})

{kl_mcp_client-2.1.8.dist-info → kl_mcp_client-2.1.10.dist-info}/METADATA

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

kl_mcp_client-2.1.10.dist-info/RECORD

@@ -0,0 +1,11 @@
+kl_mcp_client/__init__.py,sha256=pdJdBcEH5HaRuHSe2B7VUyRgH5ad3u1dDc4euZMDRMY,106
+kl_mcp_client/__version__.py,sha256=Uq-M9LFtR8tnGSaOR2w76lZ0qh5z5wwReA5I7feMj0k,23
+kl_mcp_client/client.py,sha256=ujhRp0zC5GJKnBYziIPMdKZqrhv8K2t6tBAuwYw7q_k,4513
+kl_mcp_client/tools.py,sha256=eLxWEIh0u72ao8jpkylbP2-1TpYHdPpCDISrq2H5WvA,20212
+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=t-3iQnYzOCKjuPqhMlHh7XTbsSgyhcfnJNPrZff5X-c,13510
+kl_mcp_client-2.1.10.dist-info/METADATA,sha256=jhYWCn9UZZStwF_J3eQNhfY-LCMleFjgXhykLaExei0,4444
+kl_mcp_client-2.1.10.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+kl_mcp_client-2.1.10.dist-info/top_level.txt,sha256=wd_HFFyGjiKavwACuj8Ny0svtVyNsrxCSVU48EkoQ7c,14
+kl_mcp_client-2.1.10.dist-info/RECORD,,

kl_mcp_client-2.1.8.dist-info/RECORD

@@ -1,11 +0,0 @@
-kl_mcp_client/__init__.py,sha256=pdJdBcEH5HaRuHSe2B7VUyRgH5ad3u1dDc4euZMDRMY,106
-kl_mcp_client/__version__.py,sha256=gijF1N5K1fcUKO93GIRamnDCwaUJ3bjN5UgukTujZ20,22
-kl_mcp_client/client.py,sha256=ujhRp0zC5GJKnBYziIPMdKZqrhv8K2t6tBAuwYw7q_k,4513
-kl_mcp_client/tools.py,sha256=kEkeG75SUUostCR5gRjLIjJzHg6-iWzXakjf3nvgXKk,18733
-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=ayOqGYoiQ0q15xXz_7sKFq9UzUAqaOG0Uscy6uyvErM,11992
-kl_mcp_client-2.1.8.dist-info/METADATA,sha256=rKlfrw0YCBeqCfshpQj7yHanopgJF0mxLHIJvm-Ob0A,4443
-kl_mcp_client-2.1.8.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-kl_mcp_client-2.1.8.dist-info/top_level.txt,sha256=wd_HFFyGjiKavwACuj8Ny0svtVyNsrxCSVU48EkoQ7c,14
-kl_mcp_client-2.1.8.dist-info/RECORD,,