@rpx_/mcpx

Professional Browser Automation MCP Server

Control browsers through AI with Model Context Protocol tools for web automation, testing, and data collection. Perfect for Claude, Cursor, and other MCP-compatible AI applications.

🚀 Quick Start

Installation

npm install -g @rpx_/mcpx

MCP Client Configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "browsermcp": {
      "command": "npx",
      "args": ["@rpx_/mcpx@latest"]
    }
  }
}

Configuration File Locations:

• Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json

Browser Extension

Install the companion browser extension for full functionality:

• Chrome Web Store: mcpX Browser Extension (coming soon)
• Manual Install: GitHub Repository

🛠️ Available Tools

📱 Navigation & History

• open-tab - Open new browser tabs with URLs and focus control
• tab-back - Navigate back in browser history
• tab-forward - Navigate forward in browser history

🖱️ Interaction & Scrolling

• tab-click - Click elements using CSS selectors with timeout support
• hover - Hover over elements to trigger interactive states
• tab-scroll - Scroll pages or elements (up, down, left, right, top, bottom)

⌨️ Input & Keyboard

• type-text - Type text into input fields with configurable delay
• press-key - Simulate keyboard shortcuts with modifier key support

📸 Capture & Monitoring

• screenshot - Capture full-page or viewport screenshots (PNG/JPEG)
• snapshot - Get DOM snapshots with interactive element detection
• console-logs - Retrieve browser console logs with level filtering

⏱️ Utility & Timing

• wait - Wait for time, elements, or navigation with timeout control

Browser Extension Integration

The server requires the mcpX browser extension to be installed and connected for full functionality. The extension handles:

• Secure WebSocket communication
• DOM manipulation and interaction
• Screenshot and snapshot capture
• Console log retrieval

🛡️ Privacy & Security

• Local Operation Only - All automation happens locally
• No External Connections - Zero external data transmission
• Secure WebSocket - Encrypted local communication only
• Minimal Permissions - Browser extension uses minimal required permissions

📞 Support

• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions

📈 Requirements

• Node.js: ≥18.18.0
• Browser: Chrome, Edge, or Chromium-based browsers
• MCP Client: Claude Desktop, Cursor, or other MCP-compatible applications

Built for AI-powered browser automation

⭐ Star on GitHub • 📦 NPM Package • 🌐 Browser Extension