Browser Automation · MODEL CONTEXT PROTOCOL

angiejones mcp selenium

An MCP implementation for Selenium WebDriver

WHAT IT CONNECTS

What angiejones mcp selenium gives an AI Agent

  • Start browser sessions with customizable options
  • Navigate to URLs
  • Find elements using various locator strategies
  • Click, type, and interact with elements
  • Perform mouse actions (hover, drag and drop)
  • Handle keyboard input
  • Take screenshots
  • Upload files
  • Support for headless mode
  • Chrome
  • Firefox
  • Name: `Selenium MCP`
  • Description: `automates browser interactions`
  • Command: `npx -y @angiejones/mcp-selenium`
  • Clone the repository
  • Install dependencies: `npm install`
  • Run the server: `npm start`
  • `browser` (required): Browser to launch
  • Type: string
  • Enum: ["chrome", "firefox"]
  • `options`: Browser configuration options
  • Type: object
  • Properties:
  • `headless`: Run browser in headless mode
  • Type: boolean
  • `arguments`: Additional browser arguments
  • Type: array of strings
  • `url` (required): URL to navigate to
  • Type: string
  • `by` (required): Locator strategy
  • Type: string
  • Enum: ["id", "css", "xpath", "name", "tag", "class"]
  • `value` (required): Value for the locator strategy
  • Type: string
  • `timeout`: Maximum time to wait for element in milliseconds
  • Type: number
  • Default: 10000
  • `by` (required): Locator strategy
  • Type: string
  • Enum: ["id", "css", "xpath", "name", "tag", "class"]
  • `value` (required): Value for the locator strategy
  • Type: string
  • `timeout`: Maximum time to wait for element in milliseconds
  • Type: number
  • Default: 10000
  • `by` (required): Locator strategy
  • Type: string
  • Enum: ["id", "css", "xpath", "name", "tag", "class"]
  • `value` (required): Value for the locator strategy
  • Type: string
  • `text` (required): Text to enter into the element
  • Type: string
  • `timeout`: Maximum time to wait for element in milliseconds
  • Type: number
  • Default: 10000
  • `by` (required): Locator strategy
  • Type: string
  • Enum: ["id", "css", "xpath", "name", "tag", "class"]
  • `value` (required): Value for the locator strategy
  • Type: string
  • `timeout`: Maximum time to wait for element in milliseconds
  • Type: number
  • Default: 10000
  • `by` (required): Locator strategy
  • Type: string
  • Enum: ["id", "css", "xpath", "name", "tag", "class"]
  • `value` (required): Value for the locator strategy
  • Type: string
  • `timeout`: Maximum time to wait for element in milliseconds
  • Type: number
  • Default: 10000
  • `by` (required): Locator strategy for source element
  • Type: string
  • Enum: ["id", "css", "xpath", "name", "tag", "class"]
  • `value` (required): Value for the source locator strategy
  • Type: string
  • `targetBy` (required): Locator strategy for target element
  • Type: string
  • Enum: ["id", "css", "xpath", "name", "tag", "class"]
  • `targetValue` (required): Value for the target locator strategy
  • Type: string
  • `timeout`: Maximum time to wait for elements in milliseconds
  • Type: number
  • Default: 10000
  • `by` (required): Locator strategy
  • Type: string
  • Enum: ["id", "css", "xpath", "name", "tag", "class"]
  • `value` (required): Value for the locator strategy
  • Type: string
  • `timeout`: Maximum time to wait for element in milliseconds
  • Type: number
  • Default: 10000
  • `by` (required): Locator strategy
  • Type: string
  • Enum: ["id", "css", "xpath", "name", "tag", "class"]
  • `value` (required): Value for the locator strategy
  • Type: string
  • `timeout`: Maximum time to wait for element in milliseconds
  • Type: number
  • Default: 10000
  • `key` (required): Key to press (e.g., 'Enter', 'Tab', 'a', etc.)
  • Type: string
  • `by` (required): Locator strategy
  • Type: string
  • Enum: ["id", "css", "xpath", "name", "tag", "class"]
  • `value` (required): Value for the locator strategy
  • Type: string
  • `filePath` (required): Absolute path to the file to upload
  • Type: string
  • `timeout`: Maximum time to wait for element in milliseconds
  • Type: number
  • Default: 10000
  • `outputPath` (optional): Path where to save the screenshot. If not provided, returns base64 data.
  • Type: string

SECURITY

An MCP listing is not a security review

An MCP server may receive model context, credentials, local files, or permission to call external systems. Review its code, requested environment variables, network behavior, package provenance, and maintenance status before connecting it to an agent.