puppeteer-mcp-server-ws

Exposes Puppeteer browser automation capabilities as an MCP (Model Context Protocol) server over WebSocket connections, allowing LLM clients to control headless Chrome/Chromium instances through standardized tool-calling interfaces. Implements the MCP server specification to translate tool invocations into Puppeteer API calls, managing browser lifecycle and session state across multiple concurrent client connections.

Provides tools to navigate to URLs, wait for page load conditions, and retrieve page content (HTML, text, screenshots) via Puppeteer's page automation API. Implements timeout-based wait strategies (waitForNavigation, waitForSelector) to handle dynamic content loading and AJAX-driven pages, returning structured page state to the LLM client.

Enables clicking, typing, and form submission on page elements via CSS selectors or XPath queries. Implements Puppeteer's type(), click(), and evaluate() methods to interact with DOM elements, with built-in error handling for missing selectors and stale element references. Supports keyboard shortcuts, file uploads, and multi-step form workflows.

Executes arbitrary JavaScript in the page context to query and extract structured data from the DOM. Uses Puppeteer's page.evaluate() to run functions in the browser's JavaScript runtime, returning JSON-serializable results. Supports complex queries (e.g., 'extract all product listings as JSON') without requiring the LLM to parse raw HTML.

Manages multiple browser pages/tabs within a single browser context, allowing LLM agents to switch between pages, maintain separate session states, and coordinate interactions across multiple URLs. Implements page pooling and lifecycle management to track open pages and clean up resources. Supports isolated cookies and local storage per context.

Intercepts and logs HTTP requests and responses made by the page, enabling inspection of API calls, network timing, and response payloads. Uses Puppeteer's request interception API to capture network events, optionally blocking or modifying requests. Useful for debugging, extracting API responses, and understanding page behavior.

Collects performance metrics (page load time, Core Web Vitals, memory usage, CPU) from the browser using Puppeteer's metrics API and Chrome DevTools Protocol. Provides timing breakdowns (DNS, TCP, TLS, TTFB, DOM interactive) and resource usage statistics for performance analysis and optimization.

Manages browser cookies and local storage for session persistence and authentication. Allows setting, getting, and clearing cookies/storage across pages in a context. Supports cookie attributes (domain, path, expiry, secure, httpOnly) for fine-grained control. Useful for maintaining login sessions and testing authentication flows.