What is Selenium Mcp Server Python

Selenium MCP Server is an implementation of the Model Context Protocol (MCP) for automating web browsers using Selenium WebDriver in Python. It allows users to control web browsers programmatically through the Claude desktop application.

Use cases

Use cases include automated testing of web applications, scraping web data, performing repetitive browser tasks, and enhancing productivity in web development workflows.

How to use

To use selenium-mcp-server-python, clone the repository, install the required dependencies, and run the server script. After starting the server, enable it in the Claude desktop application under Developer Options to access Selenium automation features.

Key features

Key features include support for Chrome and Firefox, a comprehensive set of Selenium WebDriver operations, easy integration with Claude, and various browser interaction capabilities such as navigation, element interaction, screenshot capture, window handling, and local storage management.

Where to use

Selenium MCP Server can be used in web automation tasks, testing web applications, and any scenario where programmatic control of web browsers is required, especially in conjunction with the Claude desktop application.

Selenium MCP Server

A Model Context Protocol (MCP) server implementation for Selenium WebDriver automation using Python. This server allows you to control web browsers programmatically through Claude’s desktop application.

Features

• Browser automation with Chrome and Firefox support
• Comprehensive set of Selenium WebDriver operations
• Easy integration with Claude desktop application
• Support for various browser interactions:
  • Navigation
  • Element interaction (click, send keys, etc.)
  • Screenshot capture
  • Window and iframe handling
  • Local storage management
  • And much more!

Prerequisites

• Python 3.7+
• Chrome or Firefox browser installed
• Claude desktop application

Installation

1. Clone this repository:

git clone https://github.com/Jyothishkumarav/selenium-mcp-server-python.git
cd selenium-mcp-server-python

2. Install the required dependencies:

pip install -r requirements.txt

3. Install the MCP server in Claude:

mcp install server.py

Usage

1. Start the server:

python server.py

2. In Claude desktop application:
   • Go to Settings > Developer Options
   • You should see “MCP-Selenium” listed as an available server
   • Enable the server to start using Selenium automation features

Available Tools

The server provides the following automation capabilities:

• Browser Management:

  • Start browser sessions
  • Close sessions
  • Switch between windows

• Navigation:

  • Navigate to URLs
  • Refresh pages
  • Wait for page loads

• Element Interaction:

  • Find elements
  • Click elements
  • Send keys
  • Clear fields
  • Double click
  • Right click

• Element Information:

  • Get element text
  • Get element attributes
  • Check element presence
  • Check element visibility
  • Check element selection

• Page Operations:

  • Take screenshots
  • Get page content
  • Scroll pages
  • Manage local storage

• Frame Handling:

  • Switch to iframes
  • Return to default content

Example Usage

Here’s a simple example of how to use the server with Claude:

1. Start a browser session
2. Navigate to a website
3. Find and interact with elements
4. Take screenshots
5. Close the session

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Selenium WebDriver
• Model Context Protocol
• Claude Desktop