ash npm install -g selenium-mcp-server ``` ## Quick Start ### 🎯 **Zero-Installation (Recommended)** #### 1. Add Configuration Create `.cursor/mcp.json` in your project root: ```json { "mcpServers": { "selenium": { "command": "npx", "args": [ "selenium-mcp-server@latest", "--browser", "chrome" ] } } } ``` #### 2. Restart Cursor - Quit Cursor completely - Restart Cursor - npx will automatically download and run the server

Alternative Setup Methods

### Option A: Local Installation #### 1. Install in your project ```bash npm install selenium-mcp-server ``` #### 2. Configure Cursor ```json { "mcpServers": { "selenium": { "command": "node", "args": ["./node_modules/selenium-mcp-server/dist/index.js", "--browser", "chrome", "--headless"] } } } ``` ### Option B: Global Installation #### 1. Install globally ```bash npm install -g selenium-mcp-server ``` #### 2. Configure Cursor ```json { "mcpServers": { "selenium": { "command": "selenium-mcp", "args": ["--browser", "chrome", "--headless"] } } } ```

### 3. Use in Cursor Ask Cursor to perform browser automation: - "Navigate to google.com and take a screenshot" - "Fill out the contact form on example.com" - "Extract all links from the current page" ## Configuration Options ```bash selenium-mcp [options] Options: --browser Browser to use (chrome, firefox, edge, safari) (default: "chrome") --headless Run browser in headless mode --executable-path Path to browser executable --user-data-dir Path to user data directory --isolated Keep browser profile in memory --viewport-size Browser viewport size (e.g., 1280,720) --output-dir Path to directory for output files -h, --help Display help for command ``` ## Available Tools ### Navigation - `browser_navigate` - Navigate to URLs - `browser_navigate_back` - Go back in history - `browser_navigate_forward` - Go forward in history ### Page Interaction - `browser_click` - Click on elements - `browser_type` - Type text into inputs - `browser_hover` - Hover over elements - `browser_drag` - Drag and drop elements - `browser_select_option` - Select dropdown options - `browser_press_key` - Press keyboard keys ### Information Gathering - `browser_snapshot` - Capture accessibility tree - `browser_take_screenshot` - Take screenshots - `browser_network_requests` - List network requests - `browser_console_messages` - Get console messages ### Tab Management - `browser_tab_list` - List open tabs - `browser_tab_new` - Open new tabs - `browser_tab_select` - Switch tabs - `browser_tab_close` - Close tabs ### Utilities - `browser_wait_for` - Wait for elements/text - `browser_file_upload` - Upload files - `browser_handle_dialog` - Handle alerts/dialogs - `browser_resize` - Resize browser window - `browser_pdf_save` - Save page as PDF ## Usage Examples ### Basic Navigation and Screenshot ```javascript // In Cursor, ask: "Navigate to https://example.com and take a screenshot" ``` ### Form Interaction ```javascript // In Cursor, ask: "Go to the contact page and fill out the form with name 'John Doe' and email 'john@example.com'" ``` ### Data Extraction ```javascript // In Cursor, ask: "Visit the product page and extract all product names and prices" ``` ## Requirements - Node.js 18+ - Java 11+ (for Selenium WebDriver) - Browser drivers (automatically managed by WebDriverManager) ## Configuration Examples ### Local Development ```json { "mcpServers": { "selenium": { "command": "selenium-mcp", "args": ["--browser", "chrome"] } } } ``` ### Headless Production ```json { "mcpServers": { "selenium": { "command": "selenium-mcp", "args": [ "--browser", "chrome", "--headless", "--viewport-size", "1920,1080" ] } } } ``` ### Custom Browser Path ```json { "mcpServers": { "selenium": {

Selenium MCP Server

Comments