{"_id":"@agmod/runbrowser-mcp","name":"@agmod/runbrowser-mcp","dist-tags":{"latest":"0.0.2"},"versions":{"0.0.2":{"name":"@agmod/runbrowser-mcp","version":"0.0.2","description":"MCP server for RunBrowser — control your running Chrome browser via Playwright","type":"module","main":"dist/index.js","types":"dist/index.d.ts","bin":{"runbrowser-mcp":"bin.js"},"keywords":["mcp","model-context-protocol","playwright","browser","automation","chrome","runbrowser"],"repository":{"type":"git","url":"git+https://github.com/yuanjiwei/runbrowser.git","directory":"packages/mcp"},"homepage":"https://github.com/yuanjiwei/runbrowser","license":"MIT","publishConfig":{"access":"public"},"engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"^1.25.2","cac":"^6.7.14","string-dedent":"^3.0.2","zod":"^4.3.5","@agmod/runbrowser-core":"0.0.2","@agmod/runbrowser-relay":"0.0.2"},"devDependencies":{"@types/node":"^24.10.1","typescript":"^5.9.3"},"scripts":{"build":"tsc","typecheck":"tsc --noEmit"},"_id":"@agmod/runbrowser-mcp@0.0.2","bugs":{"url":"https://github.com/yuanjiwei/runbrowser/issues"},"_integrity":"sha512-rKPZbqmEOPUPYobuMs6/l2dtsL2sb8gnqjDE1OUE1taJ6hJAtdcpSfMOmNm9ckU7yL1dgmlS4oZ4+yemqvt9ew==","_resolved":"/private/var/folders/6q/n5pt_9hx3mbcbk1_wj92_r_r0000gn/T/6914856787d900afff33a1bdecd4d9c8/agmod-runbrowser-mcp-0.0.2.tgz","_from":"file:agmod-runbrowser-mcp-0.0.2.tgz","_nodeVersion":"25.6.1","_npmVersion":"11.9.0","dist":{"integrity":"sha512-rKPZbqmEOPUPYobuMs6/l2dtsL2sb8gnqjDE1OUE1taJ6hJAtdcpSfMOmNm9ckU7yL1dgmlS4oZ4+yemqvt9ew==","shasum":"67999a9edd24db541d9c4059d7bac5efbea9ce85","tarball":"https://registry.npmjs.org/@agmod/runbrowser-mcp/-/runbrowser-mcp-0.0.2.tgz","fileCount":19,"unpackedSize":43783,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDBApTMwT6hvS0Rhl8MTRoJzesaphVyzzkB97lYB10kdQIhANwqyIk7wAR7sk81U43fdJmUeFme9yKOZHON6uiNf4ES"}]},"_npmUser":{"name":"agmod","email":"jiwei@agmod.com"},"directories":{},"maintainers":[{"name":"agmod","email":"jiwei@agmod.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/runbrowser-mcp_0.0.2_1772664487593_0.22402965449594436"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-04T22:48:07.481Z","0.0.2":"2026-03-04T22:48:07.741Z","modified":"2026-03-04T22:48:07.998Z"},"maintainers":[{"name":"agmod","email":"jiwei@agmod.com"}],"description":"MCP server for RunBrowser — control your running Chrome browser via Playwright","homepage":"https://github.com/yuanjiwei/runbrowser","keywords":["mcp","model-context-protocol","playwright","browser","automation","chrome","runbrowser"],"repository":{"type":"git","url":"git+https://github.com/yuanjiwei/runbrowser.git","directory":"packages/mcp"},"bugs":{"url":"https://github.com/yuanjiwei/runbrowser/issues"},"license":"MIT","readme":"# @agmod/runbrowser-mcp\n\nStandalone MCP (Model Context Protocol) server for [RunBrowser](https://github.com/yuanjiwei/runbrowser) — control your running Chrome browser via Playwright with your logins, extensions, and cookies already there.\n\n## Setup\n\n### Prerequisites\n\n1. [**Install the RunBrowser Extension**](https://chromewebstore.google.com/detail/@agmod/runbrowser-mcp/jfeammnjpkecdekppnclgkkffahnhfhe) from Chrome Web Store\n2. Click the extension icon on a tab → turns green when connected\n\n### MCP Client Configuration\n\nAdd to your MCP client settings (e.g., Claude Desktop, Cursor, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"runbrowser\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agmod/runbrowser-mcp@latest\"]\n    }\n  }\n}\n```\n\n## MCP Tools\n\nThe server exposes the following tools:\n\n| Tool | Description |\n|------|-------------|\n| **`execute`** | Run Playwright code snippets with `{page, state, context}` in scope |\n| **`reset`** | Recreate CDP connection and reset browser/page/context |\n| **`snapshot`** | Take accessibility snapshot of the current page (fast, text-based) |\n| **`screenshot`** | Take screenshot with Vimium-style accessibility labels overlaid |\n\n## MCP Resources\n\n| Resource | Description |\n|----------|-------------|\n| `debugger-api` | Debugger API documentation |\n| `editor-api` | Live editor API documentation |\n| `styles-api` | CSS styles inspection API documentation |\n\n## Environment Variables\n\n### `RUNBROWSER_AUTO_ENABLE`\n\nAuto-create a tab when Playwright connects (no manual extension click needed).\n\n```json\n{\n  \"mcpServers\": {\n    \"runbrowser\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agmod/runbrowser-mcp@latest\"],\n      \"env\": {\n        \"RUNBROWSER_AUTO_ENABLE\": \"1\"\n      }\n    }\n  }\n}\n```\n\n## Remote Agents (Devcontainers, VMs, SSH)\n\nRun agents in isolated environments while controlling Chrome on your host.\n\n**On host (where Chrome runs):**\n\n```bash\nnpx -y runbrowser serve --token <secret>\n```\n\n**In container/VM (where agent runs):**\n\n```json\n{\n  \"mcpServers\": {\n    \"runbrowser\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agmod/runbrowser-mcp@latest\", \"--host\", \"host.docker.internal\", \"--token\", \"<secret>\"]\n    }\n  }\n}\n```\n\nOr with environment variables:\n\n```json\n{\n  \"mcpServers\": {\n    \"runbrowser\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agmod/runbrowser-mcp@latest\"],\n      \"env\": {\n        \"RUNBROWSER_HOST\": \"host.docker.internal\",\n        \"RUNBROWSER_TOKEN\": \"<secret>\"\n      }\n    }\n  }\n}\n```\n\nUse `host.docker.internal` for devcontainers, or your host's IP for VMs/SSH.\n\n## Programmatic Usage\n\n```ts\nimport { startMcp } from '@agmod/runbrowser-mcp'\n\n// Start MCP server (connects to stdio transport)\nawait startMcp()\n\n// With remote relay server\nawait startMcp({\n  host: 'host.docker.internal',\n  token: 'your-secret-token',\n})\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-fd64689cceb8e94e8729b44f78ac09a5"}