{"id":26057584,"url":"https://github.com/robertheadley/chrome-debug-mcp","last_synced_at":"2026-04-30T12:33:43.448Z","repository":{"id":280881600,"uuid":"943483539","full_name":"robertheadley/chrome-debug-mcp","owner":"robertheadley","description":"An MCP server to allow you to debug webpages using LLMs","archived":false,"fork":false,"pushed_at":"2025-03-19T03:20:42.000Z","size":105,"stargazers_count":12,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-19T03:28:17.450Z","etag":null,"topics":["chrome","cline","debugger","debugging","dom","llm","mcp","mcp-server","roo-code","roocode"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robertheadley.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-05T19:25:33.000Z","updated_at":"2025-03-19T02:48:47.000Z","dependencies_parsed_at":"2025-03-05T20:53:58.466Z","dependency_job_id":null,"html_url":"https://github.com/robertheadley/chrome-debug-mcp","commit_stats":null,"previous_names":["robertheadley/chrome-debug-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/robertheadley/chrome-debug-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertheadley%2Fchrome-debug-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertheadley%2Fchrome-debug-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertheadley%2Fchrome-debug-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertheadley%2Fchrome-debug-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robertheadley","download_url":"https://codeload.github.com/robertheadley/chrome-debug-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robertheadley%2Fchrome-debug-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32465009,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T22:27:22.272Z","status":"online","status_checked_at":"2026-04-30T02:00:05.929Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["chrome","cline","debugger","debugging","dom","llm","mcp","mcp-server","roo-code","roocode"],"created_at":"2025-03-08T11:49:44.840Z","updated_at":"2026-04-30T12:33:43.442Z","avatar_url":"https://github.com/robertheadley.png","language":"JavaScript","funding_links":[],"categories":["Browser Automation","Developer Tools","JavaScript","Web Search MCP Servers"],"sub_categories":["How to Submit"],"readme":"# Chrome Debug MCP Playwright\r\n\r\nA Model Context Protocol (MCP) implementation for browser automation using Playwright, with full Greasemonkey API support.\r\n\u003ca href=\"https://glama.ai/mcp/servers/nguhnsghor\"\u003e\r\n\r\n \r\n\r\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/nguhnsghor/badge\" alt=\"Chrome Debug Server MCP server\" /\u003e\r\n \r\n\r\n\u003c/a\u003e\r\n \r\n\r\n## Features\r\n\r\n### Core Browser Features\r\n- Browser launch and management\r\n- Multi-tab support with create/switch/close capabilities\r\n- Page navigation and interaction\r\n- Screenshot capture\r\n\r\n### Greasemonkey API Support\r\n- GM_addStyle for CSS injection\r\n- GM_getValue/GM_setValue for data storage\r\n- GM_deleteValue for storage cleanup\r\n- GM_notification for desktop notifications\r\n- GM_setClipboard for clipboard operations\r\n- GM_xmlhttpRequest for cross-origin requests\r\n\r\n### Resource Management\r\n- Network request interception\r\n- Request blocking, modification, and logging\r\n- Resource type filtering\r\n\r\n### Debug Features\r\n- Detailed logging system\r\n- Log file organization\r\n- Clean interface output\r\n\r\n## Installation\r\n\r\n```bash\r\nnpm install chrome-debug-mcp-playwright\r\n```\r\n\r\n## Quick Start\r\n\r\n```javascript\r\n// Launch browser\r\ntool browser launch_browser --url \"https://example.com\" --browserType \"chromium\"\r\n\r\n// Use GM functions\r\ntool browser gm_setValue --key \"setting\" --value \"test\"\r\ntool browser gm_getValue --key \"setting\"\r\n\r\n// Intercept requests\r\ntool browser intercept_requests --patterns [\"*.jpg\", \"*.css\"] --action \"block\"\r\n```\r\n\r\n## Documentation\r\n- [Commands](COMMANDS.md) - Detailed command documentation with examples\r\n- Full command list with usage examples available in COMMANDS.md\r\n\r\n## Core Features\r\n\r\n### Browser Management\r\n```javascript\r\n// Launch browser\r\ntool browser launch_browser --url \"https://example.com\"\r\n\r\n// Create new tab\r\ntool browser create_tab --url \"https://example.com\"\r\n\r\n// Switch between tabs\r\ntool browser switch_tab --index 1\r\n```\r\n\r\n### Greasemonkey API\r\n```javascript\r\n// Add custom styles\r\ntool browser gm_addStyle --css \"body { background: #f0f0f0; }\"\r\n\r\n// Store data\r\ntool browser gm_setValue --key \"setting\" --value \"test\"\r\n\r\n// Make cross-origin requests\r\ntool browser gm_xmlhttpRequest --url \"https://api.example.com/data\" --method \"GET\"\r\n```\r\n\r\n### Resource Interception\r\n```javascript\r\n// Block image loading\r\ntool browser intercept_requests --patterns [\"*.jpg\", \"*.png\"] --action \"block\"\r\n\r\n// Log all CSS requests\r\ntool browser intercept_requests --patterns [\"*.css\"] --action \"log\"\r\n```\r\n\r\n## Implementation Details\r\n\r\n### Logging System\r\n- All debug output redirected to log files\r\n- Timestamped entries\r\n- Organized in logs directory\r\n- Clean interface output\r\n\r\n### Error Handling\r\n- Detailed error logging\r\n- Proper cleanup on errors\r\n- Resource management\r\n\r\n## Dependencies\r\n- Playwright: Browser automation\r\n- @modelcontextprotocol/sdk: MCP implementation\r\n\r\n## Development\r\n\r\n### Prerequisites\r\n- Node.js 16 or higher\r\n- npm 7 or higher\r\n\r\n### Setup\r\n```bash\r\ngit clone https://github.com/yourusername/chrome-debug-mcp-playwright.git\r\ncd chrome-debug-mcp-playwright\r\nnpm install\r\n```\r\n\r\n## License\r\n\r\nMIT License - See LICENSE file for details.\r\n\r\n## Contributing\r\n\r\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\r\n\r\n## Acknowledgments\r\n\r\nBased on the original [chrome-debug-mcp](https://github.com/robertheadley/chrome-debug-mcp) by Robert Headley.\r\n=======\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n# Chrome Debug MCP Server\r\n\r\nA Model Context Protocol (MCP) server for controlling Chrome with debugging capabilities, userscript injection, and extension support.\r\n\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n=======\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n\u003ca href=\"https://glama.ai/mcp/servers/nguhnsghor\"\u003e\r\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/nguhnsghor/badge\" alt=\"Chrome Debug Server MCP server\" /\u003e\r\n\u003c/a\u003e\r\n\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n## Features\r\n\r\n### Chrome Control\r\n- Launch Chrome with custom configurations\r\n- Support for custom Chrome executable paths\r\n- User profile management (default or custom user data directory)\r\n- Extension support and management\r\n- Disable Chrome's \"Automation Controlled\" banner\r\n\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n=======\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n### Page Automation\r\n- Click, type, and interact with page elements\r\n- Handle dropdowns and form inputs\r\n- Hover and wait for elements\r\n- Take screenshots of full page or elements\r\n- Navigate between pages\r\n- Set viewport size and device emulation\r\n- Extract text and attributes from elements\r\n\r\n### Tab Management\r\n- List all open tabs with their IDs and URLs\r\n- Open new tabs with specified URLs\r\n- Close tabs by ID\r\n- Switch between tabs\r\n- Track and manage multiple tab states\r\n\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n### Debugging Capabilities\r\n- Remote debugging via Chrome DevTools Protocol (CDP)\r\n- Console log capture and monitoring\r\n- JavaScript evaluation in page context\r\n- Real-time console output streaming\r\n\r\n### Userscript Support\r\n- Inject userscripts into web pages\r\n- Greasemonkey-style API support:\r\n  - `GM_setValue`/`GM_getValue` for persistent storage\r\n  - `GM_addStyle` for CSS injection\r\n  - `GM_xmlhttpRequest` for cross-origin requests\r\n  - `GM_openInTab` for new tab creation\r\n  - `GM_registerMenuCommand` for menu commands\r\n\r\n### Extension Integration\r\n- Load unpacked extensions\r\n- Maintain extension states and configurations\r\n- Support for default Chrome profile extensions\r\n- Selective extension enabling/disabling\r\n\r\n## Installation\r\n\r\n### Prerequisites\r\n- [Node.js](https://nodejs.org/) (v14 or higher)\r\n- [Chrome](https://www.google.com/chrome/) browser installed\r\n- [Visual Studio Code](https://code.visualstudio.com/)\r\n- [Roo Code Extension](https://marketplace.visualstudio.com/items?itemName=RooVeterinaryInc.roo-cline)\r\n\r\n### Installing Roo Code Extension\r\n1. Open Visual Studio Code\r\n2. Go to Extensions (Ctrl+Shift+X)\r\n3. Search for \"Roo Code\"\r\n4. Click Install\r\n\r\n### Setting up Chrome Debug MCP Server\r\n1. Clone this repository:\r\n   ```bash\r\n   git clone https://github.com/yourusername/chrome-debug-mcp.git\r\n   cd chrome-debug-mcp\r\n   ```\r\n\r\n2. Install dependencies:\r\n   ```bash\r\n   npm install\r\n   ```\r\n\r\n3. Build the project:\r\n   ```bash\r\n   npm run build\r\n   ```\r\n\r\n4. Configure in Roo Code:\r\n   Add to `cline_mcp_settings.json`:\r\n   ```json\r\n   {\r\n     \"mcpServers\": {\r\n       \"chrome-debug\": {\r\n         \"command\": \"node\",\r\n         \"args\": [\"path/to/chrome-debug-mcp/build/index.js\"],\r\n         \"disabled\": false,\r\n         \"alwaysAllow\": []\r\n       }\r\n     }\r\n   }\r\n   ```\r\n\r\n## Usage\r\n\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n=======\r\nFor a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).\r\n\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\nFor a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).\r\n\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\nFor a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).\r\n\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\nFor a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).\r\n\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\nFor a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).\r\n\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\nFor a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).\r\n\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\nFor a complete reference of all available commands, tools, and functions, see [COMMANDS.md](docs/COMMANDS.md).\r\n\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n### Basic Chrome Launch\r\n```javascript\r\nuse_mcp_tool({\r\n  server_name: \"chrome-debug\",\r\n  tool_name: \"launch_chrome\",\r\n  arguments: {\r\n    executablePath: \"C:\\\\Program Files\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe\",\r\n    url: \"https://example.com\"\r\n  }\r\n})\r\n```\r\n\r\n### Launch with Custom Profile\r\n```javascript\r\nuse_mcp_tool({\r\n  server_name: \"chrome-debug\",\r\n  tool_name: \"launch_chrome\",\r\n  arguments: {\r\n    executablePath: \"C:\\\\Program Files\\\\Google\\\\Chrome\\\\Application\\\\chrome.exe\",\r\n    userDataDir: \"path/to/chrome/profile\",\r\n    disableAutomationControlled: true\r\n  }\r\n})\r\n```\r\n\r\n### Inject Userscript\r\n```javascript\r\nuse_mcp_tool({\r\n  server_name: \"chrome-debug\",\r\n  tool_name: \"launch_chrome\",\r\n  arguments: {\r\n    url: \"https://example.com\",\r\n    userscriptPath: \"path/to/userscript.js\"\r\n  }\r\n})\r\n```\r\n\r\n### Evaluate JavaScript\r\n```javascript\r\nuse_mcp_tool({\r\n  server_name: \"chrome-debug\",\r\n  tool_name: \"evaluate\",\r\n  arguments: {\r\n    expression: \"document.title\"\r\n  }\r\n})\r\n```\r\n\r\n### Get Console Logs\r\n```javascript\r\nuse_mcp_tool({\r\n  server_name: \"chrome-debug\",\r\n  tool_name: \"get_console_logs\",\r\n  arguments: {\r\n    clear: true\r\n  }\r\n})\r\n```\r\n\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n=======\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n### Page Interaction Examples\r\n\r\n#### Click an Element\r\n```javascript\r\nuse_mcp_tool({\r\n  server_name: \"chrome-debug\",\r\n  tool_name: \"click\",\r\n  arguments: {\r\n    selector: \"#submit-button\",\r\n    delay: 500\r\n  }\r\n})\r\n```\r\n\r\n#### Type into Input\r\n```javascript\r\nuse_mcp_tool({\r\n  server_name: \"chrome-debug\",\r\n  tool_name: \"type\",\r\n  arguments: {\r\n    selector: \"#search-input\",\r\n    text: \"search query\",\r\n    delay: 100\r\n  }\r\n})\r\n```\r\n\r\n#### Select from Dropdown\r\n```javascript\r\nuse_mcp_tool({\r\n  server_name: \"chrome-debug\",\r\n  tool_name: \"select\",\r\n  arguments: {\r\n    selector: \"#country-select\",\r\n    value: \"US\"\r\n  }\r\n})\r\n```\r\n\r\n#### Wait for Element\r\n```javascript\r\nuse_mcp_tool({\r\n  server_name: \"chrome-debug\",\r\n  tool_name: \"wait_for_selector\",\r\n  arguments: {\r\n    selector: \".loading-complete\",\r\n    visible: true,\r\n    timeout: 5000\r\n  }\r\n})\r\n```\r\n\r\n#### Take Screenshot\r\n```javascript\r\nuse_mcp_tool({\r\n  server_name: \"chrome-debug\",\r\n  tool_name: \"screenshot\",\r\n  arguments: {\r\n    path: \"screenshot.png\",\r\n    fullPage: true\r\n  }\r\n})\r\n```\r\n\r\n#### Set Viewport Size\r\n```javascript\r\nuse_mcp_tool({\r\n  server_name: \"chrome-debug\",\r\n  tool_name: \"set_viewport\",\r\n  arguments: {\r\n    width: 1920,\r\n    height: 1080,\r\n    deviceScaleFactor: 1\r\n  }\r\n})\r\n```\r\n\r\n### Tab Management Examples\r\n\r\n#### List All Tabs\r\n```javascript\r\nuse_mcp_tool({\r\n  server_name: \"chrome-debug\",\r\n  tool_name: \"list_tabs\",\r\n  arguments: {}\r\n})\r\n```\r\n\r\n#### Open New Tab\r\n```javascript\r\nuse_mcp_tool({\r\n  server_name: \"chrome-debug\",\r\n  tool_name: \"new_tab\",\r\n  arguments: {\r\n    url: \"https://example.com\"\r\n  }\r\n})\r\n```\r\n\r\n#### Switch to Tab\r\n```javascript\r\nuse_mcp_tool({\r\n  server_name: \"chrome-debug\",\r\n  tool_name: \"switch_tab\",\r\n  arguments: {\r\n    tabId: \"tab-id-from-list-tabs\"\r\n  }\r\n})\r\n```\r\n\r\n#### Close Tab\r\n```javascript\r\nuse_mcp_tool({\r\n  server_name: \"chrome-debug\",\r\n  tool_name: \"close_tab\",\r\n  arguments: {\r\n    tabId: \"tab-id-from-list-tabs\"\r\n  }\r\n})\r\n```\r\n\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n## Dependencies\r\n\r\nThis project uses the following open-source packages:\r\n\r\n- [Puppeteer](https://pptr.dev/) - Chrome automation library\r\n- [chrome-remote-interface](https://github.com/cyrus-and/chrome-remote-interface) - Chrome DevTools Protocol client\r\n- [@modelcontextprotocol/sdk](https://github.com/ModelContextProtocol/sdk) - MCP SDK for server implementation\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License - see the LICENSE file for details.\r\n\r\n## Contributing\r\n\r\nSee our [Contributing Guide](CONTRIBUTING.md) for details on making contributions.\r\n\r\n## Acknowledgments\r\n\r\n- [Chrome DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/)\r\n- [Greasemonkey API](https://wiki.greasespot.net/Greasemonkey_Manual:API)\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n\u003c\u003c\u003c\u003c\u003c\u003c\u003c HEAD\r\n- [Model Context Protocol](https://modelcontextprotocol.ai)\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 8a57443 (Merge pull request #4 from robertheadley/feature/puppeteer-commands)\r\n=======\r\n- [Model Context Protocol](https://modelcontextprotocol.ai)\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n- [Model Context Protocol](https://modelcontextprotocol.ai)\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n- [Model Context Protocol](https://modelcontextprotocol.ai)\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n- [Model Context Protocol](https://modelcontextprotocol.ai)\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n- [Model Context Protocol](https://modelcontextprotocol.ai)\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n- [Model Context Protocol](https://modelcontextprotocol.ai)\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n=======\r\n- [Model Context Protocol](https://modelcontextprotocol.ai)\r\n\u003e\u003e\u003e\u003e\u003e\u003e\u003e parent of 64acbb3 (Add files via upload)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobertheadley%2Fchrome-debug-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobertheadley%2Fchrome-debug-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobertheadley%2Fchrome-debug-mcp/lists"}