A WebSocket-based browser automation tool with seamless MCP (Model Context Protocol) integration for Claude. Execute JavaScript in browsers remotely with zero configuration.
- 🚀 Zero Configuration: No environment variables or setup required
- 🔗 Automatic Session Management: Sessions saved automatically in
~/.replmirror-session - 🔄 Session Switching: Paste code in multiple browsers to switch connections
- 🌐 WebSocket Secure: Uses WSS for secure browser connections
- 🤖 MCP Integration: Works seamlessly with Claude via browser-repl MCP tool
- 📱 Multi-Browser Support: Multiple browsers can connect to the same session
npx browser-repl-websocket@latest codeThis will:
- Generate a unique session ID
- Save the session automatically to
~/.replmirror-session - Display browser connection code
Copy the generated JavaScript code and paste it into your browser's developer console.
The MCP server automatically detects your session and connects to the browser. Simply ask Claude to use the browser-repl tool to execute JavaScript!
npx browser-repl-websocket@latest code
npx browser-repl-websocket@latest code --host https://replmirror.247420.xyz- Creates a new browser session (defaults to localhost:8080)
--hostoption sets remote host (e.g.,https://replmirror.247420.xyz)--portoption sets custom port (auto-detected from host protocol)- Saves session to hidden file for persistence
- Outputs connection code for browser
npx browser-repl-websocket@latest mcp- Automatically loads saved session
- Starts MCP server for Claude integration
- No arguments required - everything is automatic!
npx browser-repl-websocket@latest connect --session <session-id>Add this to your .mcp.json file:
{
"mcpServers": {
"browser-repl": {
"command": "npx",
"args": ["-y", "browser-repl-websocket@latest", "mcp"]
}
}
}Or add via CLI:
claude mcp add --scope project browser-repl -- npx -y browser-repl-websocket@latest mcp// Ask Claude to execute this:
document.title = "Hello from Claude!";
window.location.hrefreturn {
title: document.title,
url: window.location.href,
userAgent: navigator.userAgent
};document.body.style.backgroundColor = 'lightblue';
document.querySelectorAll('a').forEach(link => console.log(link.href));- Automatic Persistence: Sessions saved to
~/.replmirror-session - Remote Host Support: Use
--host https://example.comto connect to remote WebSocket servers - Session Switching: Latest browser connection gets priority
- Multi-MCP Support: Multiple MCP servers can connect to same session
- Isolation: Different sessions don't interfere with each other
npx browser-repl-websocket@latest code --host https://your-server.comnpx browser-repl-websocket@latest code --host https://replmirror.247420.xyznpx browser-repl-websocket@latest code --host https://your-server.com --port 8080The remote host configuration is automatically saved and will be used by both the browser connection code and the MCP server.
src/core/websocket.js- WebSocket server with session managementsrc/core/client.js- WebSocket client with role-based connectionssrc/mcp/server.js- MCP browser automation serversrc/mcp/mcp-server.js- MCP protocol implementationsrc/utils/session.js- Session persistence and management
# Install dependencies
npm install
# Run locally
npm start
# Run tests
npm test
# Publish new version
npm version patch
npm publishMIT