Chrome Debug MCP Playwright

What is Chrome Debug MCP Playwright?

Chrome Debug MCP Playwright is a Model Context Protocol (MCP) server that enables browser automation using Playwright, with full Greasemonkey API support. It is designed for developers who need programmatic control over Chromium-based browsers and want to inject userscripts with storage, notification, clipboard, and cross-origin request capabilities.

How to use Chrome Debug MCP Playwright?

Install via npm install chrome-debug-mcp-playwright. Then launch a browser with tool browser launch_browser --url "https://example.com" and use additional tools for page interaction, tab management, Greasemonkey operations, and request interception. A full command reference is available in COMMANDS.md.

Key features of Chrome Debug MCP Playwright

• Browser launch and management for Chromium-based browsers
• Multi-tab support with create, switch, and close capabilities
• Full Greasemonkey API: GM_addStyle, GM_getValue, GM_setValue, GM_deleteValue, GM_notification, GM_setClipboard, GM_xmlhttpRequest
• Network request interception with blocking, modification, and logging
• Resource type filtering for granular control
• Screenshot capture of browser pages
• Detailed logging system with timestamped entries in organized log files

Use cases of Chrome Debug MCP Playwright

• Automate web interactions across multiple tabs, such as form filling and navigation
• Inject and test userscripts with Greasemonkey storage and notification APIs
• Debug web applications by intercepting and logging network requests
• Capture screenshots of pages for visual regression testing
• Block or modify resource loading (e.g., images, CSS) during automated sessions

FAQ from Chrome Debug MCP Playwright

What Greasemonkey API functions are supported?

Chrome Debug MCP Playwright supports GM_addStyle, GM_getValue, GM_setValue, GM_deleteValue, GM_notification, GM_setClipboard, and GM_xmlhttpRequest.

What are the system requirements?

You need Node.js 16 or higher, npm 7 or higher, and the Playwright browser automation library (installed automatically as a dependency).

How do I launch a browser and navigate to a URL?

Use the launch_browser tool with the --url flag, e.g., tool browser launch_browser --url "https://example.com" --browserType "chromium".

Does this server support multiple browser tabs?

Yes, it includes tools to create, switch, and close tabs, allowing you to manage multiple concurrent pages.