MCP Selenium Grid

Name: MCP Selenium Grid
Author: CatchNip

CatchNip

[pre-release, testing usage] A Model Context Protocol (MCP) server that enables AI Agents to request and manage Selenium browser instances through a secure API. Perfect for your automated browser testing needs! 🚀 [In development: creating usage examples and in-cluster setup]

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add selenium-grid --env API_TOKEN='<API_TOKEN>' --env ALLOWED_ORIGINS='<ALLOWED_ORIGINS>' --env DEPLOYMENT_MODE='<DEPLOYMENT_MODE>' --env SELENIUM_GRID__USERNAME='<SELENIUM_GRID__USERNAME>' --env SELENIUM_GRID__PASSWORD='<SELENIUM_GRID__PASSWORD>' --env SELENIUM_GRID__VNC_PASSWORD='<SELENIUM_GRID__VNC_PASSWORD>' --env SELENIUM_GRID__VNC_VIEW_ONLY='<SELENIUM_GRID__VNC_VIEW_ONLY>' --env SELENIUM_GRID__MAX_BROWSER_INSTANCES='<SELENIUM_GRID__MAX_BROWSER_INSTANCES>' --env SELENIUM_GRID__SE_NODE_MAX_SESSIONS='<SELENIUM_GRID__SE_NODE_MAX_SESSIONS>' -- uvx mcp-selenium-grid server run --host 127.0.0.1 --port 8000

~/.codex/config.toml

[mcp_servers.selenium-grid]
command = "uvx"
args = ["mcp-selenium-grid", "server", "run", "--host", "127.0.0.1", "--port", "8000"]
env = { API_TOKEN = "<API_TOKEN>", ALLOWED_ORIGINS = "<ALLOWED_ORIGINS>", DEPLOYMENT_MODE = "<DEPLOYMENT_MODE>", SELENIUM_GRID__USERNAME = "<SELENIUM_GRID__USERNAME>", SELENIUM_GRID__PASSWORD = "<SELENIUM_GRID__PASSWORD>", SELENIUM_GRID__VNC_PASSWORD = "<SELENIUM_GRID__VNC_PASSWORD>", SELENIUM_GRID__VNC_VIEW_ONLY = "<SELENIUM_GRID__VNC_VIEW_ONLY>", SELENIUM_GRID__MAX_BROWSER_INSTANCES = "<SELENIUM_GRID__MAX_BROWSER_INSTANCES>", SELENIUM_GRID__SE_NODE_MAX_SESSIONS = "<SELENIUM_GRID__SE_NODE_MAX_SESSIONS>" }

# codex mcp add selenium-grid --env API_TOKEN='<API_TOKEN>' --env ALLOWED_ORIGINS='<ALLOWED_ORIGINS>' --env DEPLOYMENT_MODE='<DEPLOYMENT_MODE>' --env SELENIUM_GRID__USERNAME='<SELENIUM_GRID__USERNAME>' --env SELENIUM_GRID__PASSWORD='<SELENIUM_GRID__PASSWORD>' --env SELENIUM_GRID__VNC_PASSWORD='<SELENIUM_GRID__VNC_PASSWORD>' --env SELENIUM_GRID__VNC_VIEW_ONLY='<SELENIUM_GRID__VNC_VIEW_ONLY>' --env SELENIUM_GRID__MAX_BROWSER_INSTANCES='<SELENIUM_GRID__MAX_BROWSER_INSTANCES>' --env SELENIUM_GRID__SE_NODE_MAX_SESSIONS='<SELENIUM_GRID__SE_NODE_MAX_SESSIONS>' -- uvx mcp-selenium-grid server run --host 127.0.0.1 --port 8000

~/.cursor/mcp.json

{
  "mcpServers": {
    "selenium-grid": {
      "command": "uvx",
      "args": [
        "mcp-selenium-grid",
        "server",
        "run",
        "--host",
        "127.0.0.1",
        "--port",
        "8000"
      ],
      "env": {
        "API_TOKEN": "<API_TOKEN>",
        "ALLOWED_ORIGINS": "<ALLOWED_ORIGINS>",
        "DEPLOYMENT_MODE": "<DEPLOYMENT_MODE>",
        "SELENIUM_GRID__USERNAME": "<SELENIUM_GRID__USERNAME>",
        "SELENIUM_GRID__PASSWORD": "<SELENIUM_GRID__PASSWORD>",
        "SELENIUM_GRID__VNC_PASSWORD": "<SELENIUM_GRID__VNC_PASSWORD>",
        "SELENIUM_GRID__VNC_VIEW_ONLY": "<SELENIUM_GRID__VNC_VIEW_ONLY>",
        "SELENIUM_GRID__MAX_BROWSER_INSTANCES": "<SELENIUM_GRID__MAX_BROWSER_INSTANCES>",
        "SELENIUM_GRID__SE_NODE_MAX_SESSIONS": "<SELENIUM_GRID__SE_NODE_MAX_SESSIONS>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "selenium-grid": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-selenium-grid",
        "server",
        "run",
        "--host",
        "127.0.0.1",
        "--port",
        "8000"
      ],
      "env": {
        "API_TOKEN": "<API_TOKEN>",
        "ALLOWED_ORIGINS": "<ALLOWED_ORIGINS>",
        "DEPLOYMENT_MODE": "<DEPLOYMENT_MODE>",
        "SELENIUM_GRID__USERNAME": "<SELENIUM_GRID__USERNAME>",
        "SELENIUM_GRID__PASSWORD": "<SELENIUM_GRID__PASSWORD>",
        "SELENIUM_GRID__VNC_PASSWORD": "<SELENIUM_GRID__VNC_PASSWORD>",
        "SELENIUM_GRID__VNC_VIEW_ONLY": "<SELENIUM_GRID__VNC_VIEW_ONLY>",
        "SELENIUM_GRID__MAX_BROWSER_INSTANCES": "<SELENIUM_GRID__MAX_BROWSER_INSTANCES>",
        "SELENIUM_GRID__SE_NODE_MAX_SESSIONS": "<SELENIUM_GRID__SE_NODE_MAX_SESSIONS>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "selenium-grid": {
      "command": "uvx",
      "args": [
        "mcp-selenium-grid",
        "server",
        "run",
        "--host",
        "127.0.0.1",
        "--port",
        "8000"
      ],
      "env": {
        "API_TOKEN": "<API_TOKEN>",
        "ALLOWED_ORIGINS": "<ALLOWED_ORIGINS>",
        "DEPLOYMENT_MODE": "<DEPLOYMENT_MODE>",
        "SELENIUM_GRID__USERNAME": "<SELENIUM_GRID__USERNAME>",
        "SELENIUM_GRID__PASSWORD": "<SELENIUM_GRID__PASSWORD>",
        "SELENIUM_GRID__VNC_PASSWORD": "<SELENIUM_GRID__VNC_PASSWORD>",
        "SELENIUM_GRID__VNC_VIEW_ONLY": "<SELENIUM_GRID__VNC_VIEW_ONLY>",
        "SELENIUM_GRID__MAX_BROWSER_INSTANCES": "<SELENIUM_GRID__MAX_BROWSER_INSTANCES>",
        "SELENIUM_GRID__SE_NODE_MAX_SESSIONS": "<SELENIUM_GRID__SE_NODE_MAX_SESSIONS>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "selenium-grid": {
      "command": "uvx",
      "args": [
        "mcp-selenium-grid",
        "server",
        "run",
        "--host",
        "127.0.0.1",
        "--port",
        "8000"
      ],
      "env": {
        "API_TOKEN": "<API_TOKEN>",
        "ALLOWED_ORIGINS": "<ALLOWED_ORIGINS>",
        "DEPLOYMENT_MODE": "<DEPLOYMENT_MODE>",
        "SELENIUM_GRID__USERNAME": "<SELENIUM_GRID__USERNAME>",
        "SELENIUM_GRID__PASSWORD": "<SELENIUM_GRID__PASSWORD>",
        "SELENIUM_GRID__VNC_PASSWORD": "<SELENIUM_GRID__VNC_PASSWORD>",
        "SELENIUM_GRID__VNC_VIEW_ONLY": "<SELENIUM_GRID__VNC_VIEW_ONLY>",
        "SELENIUM_GRID__MAX_BROWSER_INSTANCES": "<SELENIUM_GRID__MAX_BROWSER_INSTANCES>",
        "SELENIUM_GRID__SE_NODE_MAX_SESSIONS": "<SELENIUM_GRID__SE_NODE_MAX_SESSIONS>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "selenium-grid": {
      "command": "uvx",
      "args": [
        "mcp-selenium-grid",
        "server",
        "run",
        "--host",
        "127.0.0.1",
        "--port",
        "8000"
      ],
      "env": {
        "API_TOKEN": "<API_TOKEN>",
        "ALLOWED_ORIGINS": "<ALLOWED_ORIGINS>",
        "DEPLOYMENT_MODE": "<DEPLOYMENT_MODE>",
        "SELENIUM_GRID__USERNAME": "<SELENIUM_GRID__USERNAME>",
        "SELENIUM_GRID__PASSWORD": "<SELENIUM_GRID__PASSWORD>",
        "SELENIUM_GRID__VNC_PASSWORD": "<SELENIUM_GRID__VNC_PASSWORD>",
        "SELENIUM_GRID__VNC_VIEW_ONLY": "<SELENIUM_GRID__VNC_VIEW_ONLY>",
        "SELENIUM_GRID__MAX_BROWSER_INSTANCES": "<SELENIUM_GRID__MAX_BROWSER_INSTANCES>",
        "SELENIUM_GRID__SE_NODE_MAX_SESSIONS": "<SELENIUM_GRID__SE_NODE_MAX_SESSIONS>"
      }
    }
  }
}

Environment variables

API_TOKEN
ALLOWED_ORIGINS
DEPLOYMENT_MODE
SELENIUM_GRID__USERNAME
SELENIUM_GRID__PASSWORD
SELENIUM_GRID__VNC_PASSWORD
SELENIUM_GRID__VNC_VIEW_ONLY
SELENIUM_GRID__MAX_BROWSER_INSTANCES
SELENIUM_GRID__SE_NODE_MAX_SESSIONS

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related