npx selenium-mcp-server@latest --browser chrome ``` ### 3. Configure in MCP Client (e.g., Cursor, CI, or custom) Add to your `.cursor/mcp.json` or equivalent: ```json { "mcpServers": { "selenium": { "command": "selenium-mcp-server", "args": ["--browser", "chrome"] } } } ``` - For CI, run the server as a background process and point clients to its port. ## 📝 Onboarding for New Teams 1. **Install Node.js 18+ and Java 11+** 2. **Install the MCP server globally or use npx** 3. **Share the npm package name and README with your team** 4. **Provide example configs and usage (see above)** 5. **For support, use the GitHub repo issues page** ## Example `package.json` for Publishing ```json { "name": "selenium-mcp-server", "version": "1.0.0", "description": "Selenium MCP server for browser automation", "main": "index.js", "bin": { "selenium-mcp-server": "index.js" }, "repository": { "type": "git", "url": "https://github.com/your-org/selenium-mcp-server.git" }, "author": "Your Name", "license": "MIT" } ``` ## 📋 Available Tools - **`browser_navigate`** - Navigate to any URL - **`browser_snapshot`** - Get page accessibility snapshot with element references - **`browser_click`** - Click on elements using references from snapshots - **`browser_type`** - Type text into form fields with optional submission - **`browser_wait_for`** - Wait for time, text to appear, or text to disappear - **`browser_take_screenshot`** - Capture screenshots of the current page ## 🛠️ Installation & Setup ### For Cursor Users 1. **Add to Cursor Settings**: - Go to `Cursor Settings` → `MCP` → `Add new MCP Server` - Name: `selenium-mcp` - Command type: `command` - Command: `npx` - Arguments: `["selenium-mcp-server@latest"]` 2. **Alternative JSON Configuration**: ```json { "mcpServers": { "selenium-mcp": { "command": "npx", "args": ["selenium-mcp-server@latest"] } } } ``` ### For Other MCP Clients Use the same configuration pattern with your MCP client: ```json { "mcpServers": { "selenium-mcp": { "command": "npx", "args": ["selenium-mcp-server@latest"] } } } ``` ### Alternative Installation Methods

Click to see other installation options

#### Method 1: Local Installation ```bash npm install selenium-mcp-server ``` #### Method 2: Global Installation ```bash 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 Pa

Selenium MCP Server

ツール