Metadata-Version: 2.4
Name: selenium-mcp-server
Version: 1.1.6
Summary: A powerful Model Context Protocol (MCP) server that brings Selenium WebDriver automation to AI assistants
Home-page: https://github.com/krishnapollu/selenium-mcp-server
Author: Krishna Pollu
Author-email: Krishna Pollu <your.email@example.com>
Maintainer-email: Krishna Pollu <your.email@example.com>
License: MIT
Project-URL: Homepage, https://github.com/krishnapollu/selenium-mcp-server
Project-URL: Repository, https://github.com/krishnapollu/selenium-mcp-server
Project-URL: Documentation, https://github.com/krishnapollu/selenium-mcp-server#readme
Project-URL: Bug Reports, https://github.com/krishnapollu/selenium-mcp-server/issues
Project-URL: PyPI, https://pypi.org/project/selenium-mcp-server/
Keywords: selenium,webdriver,automation,mcp,model-context-protocol,ai,assistant
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.0.0
Requires-Dist: selenium>=4.0.0
Requires-Dist: webdriver-manager>=3.8.0
Requires-Dist: anyio>=3.0.0
Requires-Dist: toml>=0.10.0
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.18.0; extra == "dev"
Requires-Dist: black>=21.0; extra == "dev"
Requires-Dist: flake8>=3.8; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Selenium MCP Server

[![CI](https://github.com/krishnapollu/selenium-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/krishnapollu/selenium-mcp-server/actions/workflows/ci.yml)
[![PyPI version](https://badge.fury.io/py/selenium-mcp-server.svg)](https://badge.fury.io/py/selenium-mcp-server)
[![PyPI downloads](https://img.shields.io/pypi/dm/selenium-mcp-server.svg)](https://pypi.org/project/selenium-mcp-server/)
[![Python versions](https://img.shields.io/pypi/pyversions/selenium-mcp-server.svg)](https://pypi.org/project/selenium-mcp-server/)
[![License](https://img.shields.io/pypi/l/selenium-mcp-server.svg)](https://pypi.org/project/selenium-mcp-server/)

A powerful Model Context Protocol (MCP) server that brings Selenium WebDriver automation to AI assistants. This server enables AI tools like Claude Desktop and Cursor AI to control web browsers programmatically, making web automation accessible through natural language commands.

## 🆕 **What's New**
- **Simplified installation and configuration**
- **No local launcher scripts or auto-install hacks**
- **Standard Python packaging and usage**

## 📦 Installation

Install the Selenium MCP Server from PyPI:

```bash
pip install selenium-mcp-server
```

> **Latest version:** 1.1.5 ([PyPI link](https://pypi.org/project/selenium-mcp-server/1.1.5/))

Install or upgrade to the latest version:

```bash
pip install --upgrade selenium-mcp-server
```

## Usage

Start the server using the standard Python module command:

```bash
python -m selenium_mcp_server
```

This will launch the MCP stdio server, ready for integration with any MCP-compatible client (e.g., Cursor AI, Google Gemini, etc.).

## Configuration

Configure your MCP client to use the following command:

```json
{
  "mcpServers": {
    "selenium": {
      "command": "python",
      "args": ["-m", "selenium_mcp_server"]
    }
  }
}
```

- No local scripts or manual file downloads are required.
- The server will print its version on startup for easy verification.

## Project Structure

- All source code is now in `src/selenium_mcp_server/`.
- No unnecessary files or scripts are present in the root or src directory.
- The package is fully PEP 517/518 compliant and ready for PyPI distribution.

## 🛠️ Available Tools

(See the full list in the original README or docs)

- Browser management (start, list, switch, close sessions)
- Navigation & page info
- Element interaction (find, click, type, etc.)
- Advanced actions (hover, drag-and-drop, JS execution)
- File operations (upload, screenshot)

## 📝 Notes
- **You must run `pip install selenium-mcp-server` before using the server.**
- The MCP config only tells the client how to start the server; it does not install or fetch the code.
- This is the standard for all Python-based MCP servers and CLI tools.

## 🧹 Project Cleanup
- All unnecessary config and launcher files have been removed for simplicity.
- The only required files for users are the package itself and the MCP config.

## License
MIT License - feel free to use this in your own projects.

---

**Note**: This server is designed for legitimate automation tasks. Please respect websites' terms of service and robots.txt files when using this tool. 
