playwright-mcp-server-hellork 0.2.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. build/lib/build/lib/build/lib/playwright_mcp/__init__.py +26 -0
  2. build/lib/build/lib/build/lib/playwright_mcp/__main__.py +10 -0
  3. build/lib/build/lib/build/lib/playwright_mcp/browser.py +124 -0
  4. build/lib/build/lib/build/lib/playwright_mcp/cli.py +128 -0
  5. build/lib/build/lib/build/lib/playwright_mcp/config.py +26 -0
  6. build/lib/build/lib/build/lib/playwright_mcp/executor.py +167 -0
  7. build/lib/build/lib/build/lib/playwright_mcp/handlers.py +100 -0
  8. build/lib/build/lib/build/lib/playwright_mcp/server.py +77 -0
  9. build/lib/build/lib/build/lib/playwright_mcp/tools.py +187 -0
  10. build/lib/build/lib/playwright_mcp/__init__.py +26 -0
  11. build/lib/build/lib/playwright_mcp/__main__.py +10 -0
  12. build/lib/build/lib/playwright_mcp/browser.py +124 -0
  13. build/lib/build/lib/playwright_mcp/cli.py +128 -0
  14. build/lib/build/lib/playwright_mcp/config.py +26 -0
  15. build/lib/build/lib/playwright_mcp/executor.py +167 -0
  16. build/lib/build/lib/playwright_mcp/handlers.py +100 -0
  17. build/lib/build/lib/playwright_mcp/server.py +77 -0
  18. build/lib/build/lib/playwright_mcp/tools.py +187 -0
  19. build/lib/playwright_mcp/__init__.py +26 -0
  20. build/lib/playwright_mcp/__main__.py +10 -0
  21. build/lib/playwright_mcp/browser.py +124 -0
  22. build/lib/playwright_mcp/cli.py +128 -0
  23. build/lib/playwright_mcp/config.py +26 -0
  24. build/lib/playwright_mcp/executor.py +167 -0
  25. build/lib/playwright_mcp/handlers.py +100 -0
  26. build/lib/playwright_mcp/server.py +77 -0
  27. build/lib/playwright_mcp/tools.py +187 -0
  28. playwright_mcp/__init__.py +26 -0
  29. playwright_mcp/__main__.py +10 -0
  30. playwright_mcp/browser.py +124 -0
  31. playwright_mcp/cli.py +128 -0
  32. playwright_mcp/config.py +26 -0
  33. playwright_mcp/executor.py +167 -0
  34. playwright_mcp/handlers.py +100 -0
  35. playwright_mcp/server.py +77 -0
  36. playwright_mcp/tools.py +187 -0
  37. playwright_mcp_server_hellork-0.2.1.dist-info/METADATA +189 -0
  38. playwright_mcp_server_hellork-0.2.1.dist-info/RECORD +43 -0
  39. playwright_mcp_server_hellork-0.2.1.dist-info/WHEEL +5 -0
  40. playwright_mcp_server_hellork-0.2.1.dist-info/entry_points.txt +2 -0
  41. playwright_mcp_server_hellork-0.2.1.dist-info/licenses/LICENSE +201 -0
  42. playwright_mcp_server_hellork-0.2.1.dist-info/licenses/NOTICE +37 -0
  43. playwright_mcp_server_hellork-0.2.1.dist-info/top_level.txt +2 -0
@@ -0,0 +1,187 @@
1
+ # Copyright (c) 2024 Playwright MCP Server Contributors
2
+ # Licensed under the MIT License - see LICENSE file for details
3
+ """Tool definitions for the Playwright MCP server."""
4
+
5
+ from mcp import types
6
+
7
+ TOOLS: list[types.Tool] = [
8
+ types.Tool(
9
+ name="navigate",
10
+ description="Navigate to a URL",
11
+ input_schema={
12
+ "type": "object",
13
+ "properties": {
14
+ "url": {"type": "string", "description": "URL to navigate to"},
15
+ "page_id": {"type": "string", "description": "Page ID (optional)"},
16
+ },
17
+ "required": ["url"],
18
+ },
19
+ ),
20
+ types.Tool(
21
+ name="click",
22
+ description="Click on an element by selector",
23
+ input_schema={
24
+ "type": "object",
25
+ "properties": {
26
+ "selector": {"type": "string", "description": "CSS selector of element to click"},
27
+ "page_id": {"type": "string", "description": "Page ID (optional)"},
28
+ },
29
+ "required": ["selector"],
30
+ },
31
+ ),
32
+ types.Tool(
33
+ name="type",
34
+ description="Type text into an input element",
35
+ input_schema={
36
+ "type": "object",
37
+ "properties": {
38
+ "selector": {"type": "string", "description": "CSS selector of input element"},
39
+ "text": {"type": "string", "description": "Text to type"},
40
+ "page_id": {"type": "string", "description": "Page ID (optional)"},
41
+ },
42
+ "required": ["selector", "text"],
43
+ },
44
+ ),
45
+ types.Tool(
46
+ name="get_text",
47
+ description="Get text content from an element",
48
+ input_schema={
49
+ "type": "object",
50
+ "properties": {
51
+ "selector": {"type": "string", "description": "CSS selector of element"},
52
+ "page_id": {"type": "string", "description": "Page ID (optional)"},
53
+ },
54
+ "required": ["selector"],
55
+ },
56
+ ),
57
+ types.Tool(
58
+ name="get_page_content",
59
+ description="Get the current page HTML content",
60
+ input_schema={
61
+ "type": "object",
62
+ "properties": {
63
+ "page_id": {"type": "string", "description": "Page ID (optional)"},
64
+ },
65
+ },
66
+ ),
67
+ types.Tool(
68
+ name="take_screenshot",
69
+ description="Take a screenshot of the current page or element",
70
+ input_schema={
71
+ "type": "object",
72
+ "properties": {
73
+ "page_id": {"type": "string", "description": "Page ID (optional)"},
74
+ "selector": {"type": "string", "description": "CSS selector for element screenshot (optional)"},
75
+ "full_page": {"type": "boolean", "description": "Take full page screenshot", "default": False},
76
+ },
77
+ },
78
+ ),
79
+ types.Tool(
80
+ name="new_page",
81
+ description="Create a new browser page",
82
+ input_schema={
83
+ "type": "object",
84
+ "properties": {
85
+ "page_id": {"type": "string", "description": "Unique ID for the new page"},
86
+ },
87
+ "required": ["page_id"],
88
+ },
89
+ ),
90
+ types.Tool(
91
+ name="switch_page",
92
+ description="Switch to a different browser page",
93
+ input_schema={
94
+ "type": "object",
95
+ "properties": {
96
+ "page_id": {"type": "string", "description": "Page ID to switch to"},
97
+ },
98
+ "required": ["page_id"],
99
+ },
100
+ ),
101
+ types.Tool(
102
+ name="get_pages",
103
+ description="List all available browser pages",
104
+ input_schema={"type": "object", "properties": {}},
105
+ ),
106
+ types.Tool(
107
+ name="wait_for_selector",
108
+ description="Wait for an element to be visible on the page",
109
+ input_schema={
110
+ "type": "object",
111
+ "properties": {
112
+ "selector": {"type": "string", "description": "CSS selector to wait for"},
113
+ "page_id": {"type": "string", "description": "Page ID (optional)"},
114
+ "timeout": {"type": "number", "description": "Timeout in milliseconds", "default": 30000},
115
+ "state": {"type": "string", "enum": ["visible", "hidden", "attached", "detached"], "default": "visible"},
116
+ },
117
+ "required": ["selector"],
118
+ },
119
+ ),
120
+ types.Tool(
121
+ name="evaluate",
122
+ description="Evaluate JavaScript in the page context",
123
+ input_schema={
124
+ "type": "object",
125
+ "properties": {
126
+ "script": {"type": "string", "description": "JavaScript code to evaluate"},
127
+ "page_id": {"type": "string", "description": "Page ID (optional)"},
128
+ },
129
+ "required": ["script"],
130
+ },
131
+ ),
132
+ types.Tool(
133
+ name="get_title",
134
+ description="Get the page title",
135
+ input_schema={
136
+ "type": "object",
137
+ "properties": {
138
+ "page_id": {"type": "string", "description": "Page ID (optional)"},
139
+ },
140
+ },
141
+ ),
142
+ types.Tool(
143
+ name="get_url",
144
+ description="Get the current page URL",
145
+ input_schema={
146
+ "type": "object",
147
+ "properties": {
148
+ "page_id": {"type": "string", "description": "Page ID (optional)"},
149
+ },
150
+ },
151
+ ),
152
+ types.Tool(
153
+ name="go_back",
154
+ description="Navigate back in history",
155
+ input_schema={
156
+ "type": "object",
157
+ "properties": {
158
+ "page_id": {"type": "string", "description": "Page ID (optional)"},
159
+ },
160
+ },
161
+ ),
162
+ types.Tool(
163
+ name="go_forward",
164
+ description="Navigate forward in history",
165
+ input_schema={
166
+ "type": "object",
167
+ "properties": {
168
+ "page_id": {"type": "string", "description": "Page ID (optional)"},
169
+ },
170
+ },
171
+ ),
172
+ types.Tool(
173
+ name="reload",
174
+ description="Reload the current page",
175
+ input_schema={
176
+ "type": "object",
177
+ "properties": {
178
+ "page_id": {"type": "string", "description": "Page ID (optional)"},
179
+ },
180
+ },
181
+ ),
182
+ ]
183
+
184
+
185
+ def get_tools() -> list[types.Tool]:
186
+ """Get the list of available tools."""
187
+ return TOOLS
@@ -0,0 +1,26 @@
1
+ # Copyright (c) 2024 Playwright MCP Server Contributors
2
+ # Licensed under the MIT License - see LICENSE file for details
3
+ """Playwright MCP Server - Browser automation via Model Context Protocol."""
4
+
5
+ from .browser import BrowserManager, create_browser_manager
6
+ from .config import DEFAULT_CONFIG, BrowserConfig, ServerConfig
7
+ from .executor import ToolExecutor
8
+ from .handlers import RequestHandlers
9
+ from .server import PlaywrightMCPServer, create_server, main
10
+ from .tools import TOOLS, get_tools
11
+
12
+ __version__ = "0.2.1"
13
+ __all__ = [
14
+ "DEFAULT_CONFIG",
15
+ "TOOLS",
16
+ "BrowserConfig",
17
+ "BrowserManager",
18
+ "PlaywrightMCPServer",
19
+ "RequestHandlers",
20
+ "ServerConfig",
21
+ "ToolExecutor",
22
+ "create_browser_manager",
23
+ "create_server",
24
+ "get_tools",
25
+ "main",
26
+ ]
@@ -0,0 +1,10 @@
1
+ # Copyright (c) 2024 Playwright MCP Server Contributors
2
+ # Licensed under the MIT License - see LICENSE file for details
3
+ """Entry point for running the Playwright MCP server."""
4
+
5
+ import asyncio
6
+
7
+ from .server import main
8
+
9
+ if __name__ == "__main__":
10
+ asyncio.run(main())
@@ -0,0 +1,124 @@
1
+ # Copyright (c) 2024 Playwright MCP Server Contributors
2
+ # Licensed under the MIT License - see LICENSE file for details
3
+ """Browser lifecycle management."""
4
+
5
+ from __future__ import annotations
6
+
7
+ import asyncio
8
+ from collections.abc import AsyncIterator
9
+ from contextlib import asynccontextmanager
10
+
11
+ from playwright.async_api import Browser, BrowserContext, Page, Playwright, async_playwright
12
+
13
+ from .config import BrowserConfig, ServerConfig
14
+
15
+
16
+ class BrowserManager:
17
+ """Manages Playwright browser lifecycle and page pool."""
18
+
19
+ def __init__(self, config: BrowserConfig) -> None:
20
+ self._config = config
21
+ self._playwright: Playwright | None = None
22
+ self._browser: Browser | None = None
23
+ self._context: BrowserContext | None = None
24
+ self._pages: dict[str, Page] = {}
25
+ self._current_page_id: str | None = None
26
+ self._lock = asyncio.Lock()
27
+
28
+ @property
29
+ def is_initialized(self) -> bool:
30
+ return self._browser is not None and self._browser.is_connected()
31
+
32
+ @property
33
+ def pages(self) -> dict[str, Page]:
34
+ return self._pages
35
+
36
+ @property
37
+ def current_page_id(self) -> str | None:
38
+ return self._current_page_id
39
+
40
+ @current_page_id.setter
41
+ def current_page_id(self, value: str | None) -> None:
42
+ self._current_page_id = value
43
+
44
+ async def initialize(self) -> None:
45
+ """Initialize browser, context, and default page."""
46
+ async with self._lock:
47
+ if self.is_initialized:
48
+ return
49
+
50
+ self._playwright = await async_playwright().start()
51
+ browser_type = getattr(self._playwright, self._config.browser_type)
52
+ self._browser = await browser_type.launch(
53
+ headless=self._config.headless,
54
+ args=list(self._config.args),
55
+ slow_mo=self._config.slow_mo,
56
+ )
57
+ self._context = await self._browser.new_context()
58
+ default_page = await self._context.new_page()
59
+ self._pages["default"] = default_page
60
+ self._current_page_id = "default"
61
+
62
+ async def close(self) -> None:
63
+ """Clean up browser resources."""
64
+ async with self._lock:
65
+ if self._context:
66
+ await self._context.close()
67
+ self._context = None
68
+ if self._browser:
69
+ await self._browser.close()
70
+ self._browser = None
71
+ if self._playwright:
72
+ await self._playwright.stop()
73
+ self._playwright = None
74
+ self._pages.clear()
75
+ self._current_page_id = None
76
+
77
+ def get_page(self, page_id: str | None = None) -> Page:
78
+ """Get a page by ID, defaulting to current page."""
79
+ if page_id is None:
80
+ page_id = self._current_page_id
81
+ if page_id is None:
82
+ if self._pages:
83
+ page_id = next(iter(self._pages))
84
+ else:
85
+ raise ValueError("No pages available. Call initialize() first.")
86
+ if page_id not in self._pages:
87
+ raise ValueError(f"Page not found: {page_id}")
88
+ return self._pages[page_id]
89
+
90
+ async def create_page(self, page_id: str) -> Page:
91
+ """Create a new page with the given ID."""
92
+ if not self._context:
93
+ raise RuntimeError("Browser not initialized")
94
+ page = await self._context.new_page()
95
+ self._pages[page_id] = page
96
+ self._current_page_id = page_id
97
+ return page
98
+
99
+ def remove_page(self, page_id: str) -> bool:
100
+ """Remove a page from the pool."""
101
+ if page_id in self._pages:
102
+ # Don't actually close the page, just remove from pool
103
+ # The context will clean up on close()
104
+ del self._pages[page_id]
105
+ if self._current_page_id == page_id:
106
+ self._current_page_id = next(iter(self._pages)) if self._pages else None
107
+ return True
108
+ return False
109
+
110
+ @asynccontextmanager
111
+ async def lifespan(self) -> AsyncIterator[BrowserManager]:
112
+ """Context manager for browser lifecycle."""
113
+ await self.initialize()
114
+ try:
115
+ yield self
116
+ finally:
117
+ await self.close()
118
+
119
+
120
+ def create_browser_manager(config: ServerConfig | None = None) -> BrowserManager:
121
+ """Factory function to create a browser manager."""
122
+ if config is None:
123
+ config = ServerConfig()
124
+ return BrowserManager(config.browser)
@@ -0,0 +1,128 @@
1
+ # Copyright (c) 2024 Playwright MCP Server Contributors
2
+ # Licensed under the MIT License - see LICENSE file for details
3
+ """Command-line interface for the Playwright MCP server."""
4
+
5
+ from __future__ import annotations
6
+
7
+ import argparse
8
+ import asyncio
9
+ import logging
10
+ import sys
11
+
12
+ from .config import DEFAULT_CONFIG, BrowserConfig, ServerConfig
13
+ from .server import create_server
14
+
15
+ logger = logging.getLogger(__name__)
16
+
17
+
18
+ def parse_args(args: list[str] | None = None) -> argparse.Namespace:
19
+ """Parse command-line arguments."""
20
+ parser = argparse.ArgumentParser(
21
+ description="Playwright MCP Server - Browser automation via Model Context Protocol",
22
+ formatter_class=argparse.ArgumentDefaultsHelpFormatter,
23
+ )
24
+
25
+ parser.add_argument(
26
+ "--headless",
27
+ action="store_true",
28
+ default=None,
29
+ help="Run browser in headless mode (default: True)",
30
+ )
31
+ parser.add_argument(
32
+ "--headed",
33
+ action="store_false",
34
+ dest="headless",
35
+ help="Run browser in headed mode",
36
+ )
37
+ parser.add_argument(
38
+ "--browser",
39
+ choices=["chromium", "firefox", "webkit"],
40
+ default=None,
41
+ help="Browser type to use",
42
+ )
43
+ parser.add_argument(
44
+ "--timeout",
45
+ type=float,
46
+ default=None,
47
+ help="Default timeout in milliseconds",
48
+ )
49
+
50
+ parser.add_argument(
51
+ "--slow-mo",
52
+ type=float,
53
+ default=None,
54
+ help="Slow down operations by specified milliseconds",
55
+ )
56
+ parser.add_argument(
57
+ "--browser-arg",
58
+ action="append",
59
+ default=None,
60
+ help="Additional browser launch arguments (can be repeated)",
61
+ )
62
+ parser.add_argument(
63
+ "--log-level",
64
+ choices=["DEBUG", "INFO", "WARNING", "ERROR"],
65
+ default="INFO",
66
+ help="Logging level",
67
+ )
68
+ parser.add_argument(
69
+ "--version",
70
+ action="version",
71
+ version="%(prog)s 0.2.0",
72
+ )
73
+
74
+ return parser.parse_args(args)
75
+
76
+
77
+ def build_config(args: argparse.Namespace) -> ServerConfig:
78
+ """Build server config from parsed arguments."""
79
+ browser_config = BrowserConfig()
80
+
81
+ if args.headless is not None:
82
+ browser_config = BrowserConfig(
83
+ headless=args.headless,
84
+ browser_type=args.browser or DEFAULT_CONFIG.browser.browser_type,
85
+ args=tuple(args.browser_arg) if args.browser_arg else DEFAULT_CONFIG.browser.args,
86
+ slow_mo=args.slow_mo if args.slow_mo is not None else DEFAULT_CONFIG.browser.slow_mo,
87
+ )
88
+ elif args.browser is not None or args.browser_arg is not None or args.slow_mo is not None:
89
+ browser_config = BrowserConfig(
90
+ headless=DEFAULT_CONFIG.browser.headless,
91
+ browser_type=args.browser or DEFAULT_CONFIG.browser.browser_type,
92
+ args=tuple(args.browser_arg) if args.browser_arg else DEFAULT_CONFIG.browser.args,
93
+ slow_mo=args.slow_mo if args.slow_mo is not None else DEFAULT_CONFIG.browser.slow_mo,
94
+ )
95
+
96
+ return ServerConfig(
97
+ name=DEFAULT_CONFIG.name,
98
+ version=DEFAULT_CONFIG.version,
99
+ browser=browser_config,
100
+ default_timeout=args.timeout if args.timeout is not None else DEFAULT_CONFIG.default_timeout,
101
+ )
102
+
103
+
104
+ def main(args: list[str] | None = None) -> int:
105
+ """Main CLI entry point."""
106
+ parsed = parse_args(args)
107
+
108
+ logging.basicConfig(
109
+ level=parsed.log_level,
110
+ format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
111
+ )
112
+
113
+ config = build_config(parsed)
114
+ server = create_server(config)
115
+
116
+ try:
117
+ asyncio.run(server.run_stdio())
118
+ return 0
119
+ except KeyboardInterrupt:
120
+ logger.info("Server stopped by user")
121
+ return 130
122
+ except Exception:
123
+ logger.exception("Server error")
124
+ return 1
125
+
126
+
127
+ if __name__ == "__main__":
128
+ sys.exit(main())
@@ -0,0 +1,26 @@
1
+ # Copyright (c) 2024 Playwright MCP Server Contributors
2
+ # Licensed under the MIT License - see LICENSE file for details
3
+ """Configuration for the Playwright MCP server."""
4
+
5
+ from dataclasses import dataclass, field
6
+
7
+
8
+ @dataclass(frozen=True)
9
+ class BrowserConfig:
10
+ """Browser launch configuration."""
11
+ headless: bool = True
12
+ browser_type: str = "chromium" # chromium, firefox, webkit
13
+ args: tuple[str, ...] = field(default_factory=tuple)
14
+ slow_mo: float = 0.0
15
+
16
+
17
+ @dataclass(frozen=True)
18
+ class ServerConfig:
19
+ """Server configuration."""
20
+ name: str = "playwright-mcp"
21
+ version: str = "0.2.0"
22
+ browser: BrowserConfig = field(default_factory=BrowserConfig)
23
+ default_timeout: float = 30000.0 # ms
24
+
25
+
26
+ DEFAULT_CONFIG = ServerConfig()
@@ -0,0 +1,167 @@
1
+ # Copyright (c) 2024 Playwright MCP Server Contributors
2
+ # Licensed under the MIT License - see LICENSE file for details
3
+ """Tool execution logic for Playwright MCP server."""
4
+
5
+ from __future__ import annotations
6
+
7
+ import base64
8
+ import json
9
+ from typing import Any
10
+
11
+ from mcp import types
12
+ from playwright.async_api import Page
13
+
14
+ from .browser import BrowserManager
15
+
16
+
17
+ class ToolExecutor:
18
+ """Executes Playwright tools against a browser manager."""
19
+
20
+ def __init__(self, browser_manager: BrowserManager, default_timeout: float = 30000.0) -> None:
21
+ self._browser = browser_manager
22
+ self._default_timeout = default_timeout
23
+
24
+ async def execute(self, name: str, arguments: dict[str, Any]) -> types.CallToolResult:
25
+ """Execute a tool by name with arguments."""
26
+ try:
27
+ handler = getattr(self, f"_handle_{name}", None)
28
+ if handler is None:
29
+ raise ValueError(f"Unknown tool: {name}")
30
+ result: types.CallToolResult = await handler(arguments)
31
+ return result
32
+ except Exception as e: # noqa: BLE001
33
+ return types.CallToolResult(
34
+ content=[types.TextContent(type="text", text=f"Error: {e!s}")],
35
+ is_error=True,
36
+ )
37
+
38
+ def _get_page(self, page_id: str | None = None) -> Page:
39
+ return self._browser.get_page(page_id)
40
+
41
+ async def _handle_navigate(self, args: dict[str, Any]) -> types.CallToolResult:
42
+ page = self._get_page(args.get("page_id"))
43
+ await page.goto(args["url"], timeout=self._default_timeout)
44
+ return types.CallToolResult(
45
+ content=[types.TextContent(type="text", text=f"Navigated to {args['url']}")]
46
+ )
47
+
48
+ async def _handle_click(self, args: dict[str, Any]) -> types.CallToolResult:
49
+ page = self._get_page(args.get("page_id"))
50
+ await page.click(args["selector"], timeout=args.get("timeout", self._default_timeout))
51
+ return types.CallToolResult(
52
+ content=[types.TextContent(type="text", text=f"Clicked {args['selector']}")]
53
+ )
54
+
55
+ async def _handle_type(self, args: dict[str, Any]) -> types.CallToolResult:
56
+ page = self._get_page(args.get("page_id"))
57
+ await page.fill(args["selector"], args["text"], timeout=self._default_timeout)
58
+ return types.CallToolResult(
59
+ content=[types.TextContent(type="text", text=f"Typed into {args['selector']}")]
60
+ )
61
+
62
+ async def _handle_get_text(self, args: dict[str, Any]) -> types.CallToolResult:
63
+ page = self._get_page(args.get("page_id"))
64
+ text = await page.locator(args["selector"]).text_content(timeout=self._default_timeout)
65
+ return types.CallToolResult(
66
+ content=[types.TextContent(type="text", text=text or "")]
67
+ )
68
+
69
+ async def _handle_get_page_content(self, args: dict[str, Any]) -> types.CallToolResult:
70
+ page = self._get_page(args.get("page_id"))
71
+ content = await page.content()
72
+ return types.CallToolResult(
73
+ content=[types.TextContent(type="text", text=content)]
74
+ )
75
+
76
+ async def _handle_take_screenshot(self, args: dict[str, Any]) -> types.CallToolResult:
77
+ page = self._get_page(args.get("page_id"))
78
+ selector = args.get("selector")
79
+ full_page = args.get("full_page", False)
80
+
81
+ if selector:
82
+ screenshot = await page.locator(selector).screenshot()
83
+ elif full_page:
84
+ screenshot = await page.screenshot(full_page=True)
85
+ else:
86
+ screenshot = await page.screenshot()
87
+
88
+ b64 = base64.b64encode(screenshot).decode()
89
+ return types.CallToolResult(
90
+ content=[types.ImageContent(type="image", data=b64, mime_type="image/png")]
91
+ )
92
+
93
+ async def _handle_new_page(self, args: dict[str, Any]) -> types.CallToolResult:
94
+ page_id = args["page_id"]
95
+ await self._browser.create_page(page_id)
96
+ return types.CallToolResult(
97
+ content=[types.TextContent(type="text", text=f"Created new page: {page_id}")]
98
+ )
99
+
100
+ async def _handle_switch_page(self, args: dict[str, Any]) -> types.CallToolResult:
101
+ page_id = args["page_id"]
102
+ if page_id not in self._browser.pages:
103
+ raise ValueError(f"Page not found: {page_id}")
104
+ self._browser.current_page_id = page_id
105
+ return types.CallToolResult(
106
+ content=[types.TextContent(type="text", text=f"Switched to page: {page_id}")]
107
+ )
108
+
109
+ async def _handle_get_pages(self, args: dict[str, Any]) -> types.CallToolResult:
110
+ page_list = [
111
+ {"id": pid, "url": p.url, "title": await p.title()}
112
+ for pid, p in self._browser.pages.items()
113
+ ]
114
+ return types.CallToolResult(
115
+ content=[types.TextContent(type="text", text=json.dumps(page_list, indent=2))]
116
+ )
117
+
118
+ async def _handle_wait_for_selector(self, args: dict[str, Any]) -> types.CallToolResult:
119
+ page = self._get_page(args.get("page_id"))
120
+ selector = args["selector"]
121
+ timeout = args.get("timeout", self._default_timeout)
122
+ state = args.get("state", "visible")
123
+ await page.wait_for_selector(selector, state=state, timeout=timeout)
124
+ return types.CallToolResult(
125
+ content=[types.TextContent(type="text", text=f"Element {selector} is {state}")]
126
+ )
127
+
128
+ async def _handle_evaluate(self, args: dict[str, Any]) -> types.CallToolResult:
129
+ page = self._get_page(args.get("page_id"))
130
+ result = await page.evaluate(args["script"])
131
+ return types.CallToolResult(
132
+ content=[types.TextContent(type="text", text=json.dumps(result, default=str))]
133
+ )
134
+
135
+ async def _handle_get_title(self, args: dict[str, Any]) -> types.CallToolResult:
136
+ page = self._get_page(args.get("page_id"))
137
+ title = await page.title()
138
+ return types.CallToolResult(
139
+ content=[types.TextContent(type="text", text=title)]
140
+ )
141
+
142
+ async def _handle_get_url(self, args: dict[str, Any]) -> types.CallToolResult:
143
+ page = self._get_page(args.get("page_id"))
144
+ return types.CallToolResult(
145
+ content=[types.TextContent(type="text", text=page.url)]
146
+ )
147
+
148
+ async def _handle_go_back(self, args: dict[str, Any]) -> types.CallToolResult:
149
+ page = self._get_page(args.get("page_id"))
150
+ await page.go_back(timeout=self._default_timeout)
151
+ return types.CallToolResult(
152
+ content=[types.TextContent(type="text", text="Navigated back")]
153
+ )
154
+
155
+ async def _handle_go_forward(self, args: dict[str, Any]) -> types.CallToolResult:
156
+ page = self._get_page(args.get("page_id"))
157
+ await page.go_forward(timeout=self._default_timeout)
158
+ return types.CallToolResult(
159
+ content=[types.TextContent(type="text", text="Navigated forward")]
160
+ )
161
+
162
+ async def _handle_reload(self, args: dict[str, Any]) -> types.CallToolResult:
163
+ page = self._get_page(args.get("page_id"))
164
+ await page.reload(timeout=self._default_timeout)
165
+ return types.CallToolResult(
166
+ content=[types.TextContent(type="text", text="Page reloaded")]
167
+ )