{"_id":"@dubaigit/bdg-mcp","_rev":"2-8902edf72990645b91a880c76b96963a","name":"@dubaigit/bdg-mcp","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@dubaigit/bdg-mcp","version":"1.0.0","keywords":["mcp","cdp","chrome","browser","debugging"],"author":"","license":"MIT","_id":"@dubaigit/bdg-mcp@1.0.0","maintainers":[{"name":"dubaigit","email":"binkenaid@gmail.com"}],"bin":{"bdg-mcp":"build/index.js"},"dist":{"shasum":"20bbaa220a90eb9a126f632f91b431b82b421e6b","tarball":"https://registry.npmjs.org/@dubaigit/bdg-mcp/-/bdg-mcp-1.0.0.tgz","fileCount":6,"integrity":"sha512-tC/frgYaYDdzq8gkBJIcbtPcmd483lcEIsrCpW27DRsZ8pQJ4dMWC6WRkIWHnOX8ZmpST62DsdXuCipKdZpHUA==","signatures":[{"sig":"MEQCIAr5DMw1ploc38MaLQAScK7cOHu72atswWgpFlYfyGoiAiAjn1ux1EgH1fX7BYpkDrGGAglxRyo5hFxGkdEBnDnbHw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":41846},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=20.0.0"},"scripts":{"build":"tsc && chmod 755 build/index.js","start":"node build/index.js"},"_npmUser":{"name":"dubaigit","email":"binkenaid@gmail.com"},"_npmVersion":"11.6.2","description":"MCP server for browser debugging via Chrome DevTools Protocol using bdg","directories":{},"_nodeVersion":"24.11.1","dependencies":{"ws":"^8.18.0","zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"@types/ws":"^8.5.10","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/bdg-mcp_1.0.0_1764724895697_0.6152391580263539","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@dubaigit/bdg-mcp","version":"1.0.1","description":"MCP server for browser debugging via Chrome DevTools Protocol using bdg","type":"module","main":"build/index.js","bin":{"bdg-mcp":"build/index.js"},"scripts":{"build":"tsc && chmod 755 build/index.js","start":"node build/index.js"},"keywords":["mcp","cdp","chrome","browser","debugging"],"author":"","license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.23.8","ws":"^8.18.0"},"devDependencies":{"@types/node":"^22.0.0","@types/ws":"^8.5.10","typescript":"^5.6.0"},"engines":{"node":">=20.0.0"},"types":"./build/index.d.ts","_id":"@dubaigit/bdg-mcp@1.0.1","_nodeVersion":"24.11.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-O8ZLgkNjx9E+oz9Azri28BXQql22m6vPP6mqxJvsmcoLQhEhV3DdMqID7pp3q91+1mgU2M1v/NbPJbB3jNMZbQ==","shasum":"de056f98ff9c04a53278de5ef1575c14c4f86963","tarball":"https://registry.npmjs.org/@dubaigit/bdg-mcp/-/bdg-mcp-1.0.1.tgz","fileCount":6,"unpackedSize":41878,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIByda2ufAY3HhJITHP+OPumXG7bC8cQ53f8/QeGnHD/LAiAecyyDHXcbfCErkwHCGunNS4xLuXg33vSY5idZ3PIMvQ=="}]},"_npmUser":{"name":"dubaigit","email":"binkenaid@gmail.com"},"directories":{},"maintainers":[{"name":"dubaigit","email":"binkenaid@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/bdg-mcp_1.0.1_1764725094309_0.4738678964119869"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-03T01:21:35.575Z","modified":"2025-12-03T01:24:54.705Z","1.0.0":"2025-12-03T01:21:35.889Z","1.0.1":"2025-12-03T01:24:54.526Z"},"license":"MIT","keywords":["mcp","cdp","chrome","browser","debugging"],"description":"MCP server for browser debugging via Chrome DevTools Protocol using bdg","maintainers":[{"name":"dubaigit","email":"binkenaid@gmail.com"}],"readme":"# @dubaigit/bdg-mcp\n\nMCP (Model Context Protocol) server for browser debugging via Chrome DevTools Protocol (CDP).\n\n**Key feature:** Connect to remote Chrome browsers with API key authentication - works with Fly.io, AWS, or any cloud-hosted Chrome instance.\n\n## Installation\n\n```bash\nnpm install -g @dubaigit/bdg-mcp\n```\n\n## Add to Claude Code\n\n```bash\nclaude mcp add bdg-mcp -- npx -y @dubaigit/bdg-mcp\n```\n\nOr manually add to `~/.claude.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"bdg-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@dubaigit/bdg-mcp\"]\n    }\n  }\n}\n```\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `connect_browser` | Connect to remote Chrome via WebSocket URL with API key auth |\n| `disconnect_browser` | Disconnect from current session |\n| `browser_status` | Check connection status |\n| `navigate` | Navigate to a URL |\n| `screenshot` | Capture page screenshot (png/jpeg/webp, full page support) |\n| `evaluate` | Execute JavaScript in page context |\n| `get_page_content` | Get full HTML of current page |\n| `get_page_info` | Get URL and title |\n| `query_selector` | Find elements by CSS selector |\n| `click` | Click on element |\n| `type_text` | Type text into input fields |\n| `cdp` | Execute raw CDP commands |\n| `reload` | Reload page |\n| `go_back` / `go_forward` | Browser history navigation |\n\n## Usage Example\n\n1. Connect to a remote Chrome browser:\n```\nconnect_browser with wsUrl: \"wss://your-chrome.fly.dev:9226/devtools/page/PAGE_ID?apiKey=YOUR_API_KEY\"\n```\n\n2. Navigate and interact:\n```\nnavigate to \"https://example.com\"\nscreenshot\nget_page_info\n```\n\n3. Execute JavaScript:\n```\nevaluate expression: \"document.title\"\n```\n\n4. Raw CDP commands:\n```\ncdp method: \"Page.printToPDF\" params: { printBackground: true }\n```\n\n## Remote Chrome Setup\n\nThis MCP server is designed to work with remote Chrome browsers. You can set up a remote Chrome with CDP proxy using:\n\n- **Fly.io**: Deploy Chrome in a Docker container with a CDP proxy that handles API key authentication\n- **Your own infrastructure**: Any Chrome instance with `--remote-debugging-port` exposed\n\nExample WebSocket URL format:\n```\nwss://hostname:port/devtools/page/PAGE_ID?apiKey=YOUR_API_KEY\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}