Selenium MCP Server
A Model Context Protocol (MCP) server that provides web automation capabilities through Selenium WebDriver. This server allows AI assistants to interact with web pages by providing tools for navigation, element interaction, taking screenshots, and more.
1.1. Quick Start
1.1.1. Using Installed Package (Recommended)
# Install
pip install mcp-server-selenium
# Run
python -m mcp_server_selenium --port 9222 --user_data_dir /tmp/chrome-debug1.1.2. Using Source Code (Development)
# Clone and setup
git clone https://github.com/PhungXuanAnh/selenium-mcp-server.git
cd selenium-mcp-server
uv sync
# Run
PYTHONPATH=src python -m mcp_server_selenium --port 9222 --user_data_dir /tmp/chrome-debug- 2. Features
- 3. Available Tools
- 3.1. Navigation and Page Management
- 3.2. Element Interaction
- 3.3. Element Styling
- 3.4. JavaScript Execution
- 3.5. Browser Logs
- 3.6. Local Storage Management
- 4. Installation
- 4.1. Prerequisites
- 4.2. Installation Options
- 4.2.1. Option A: Install as Python Package (Recommended)
- 4.2.2. Option B: Run from Source Code
- 4.3. Chrome Setup
- 5. Usage
- 5.1. Running the MCP Server
- 5.1.1. Option A: From Installed Package
- 5.1.2. Option B: From Source Code
- 5.2. Using MCP Inspector for Testing
- 5.2.1. Start Inspector Server
- 5.2.2. Access Inspector Interface
- 5.2.3. Command Line Options
- 5.3. Using with MCP Clients
- 5.3.1. Configuration Examples
- 5.3.2. Debug
- 5.1. Running the MCP Server
- 6. Examples
- 6.1. Basic Web Automation
- 6.2. Advanced Usage
- 6.2.1. JavaScript Examples
- 7. Logging
- 8. Troubleshooting
- 8.1. Common Issues
- 8.1.1. Installation-Related Issues
- 8.1.2. Runtime Issues
- 8.1.3. Configuration Issues
- 8.1. Common Issues
- 9. Architecture
- 10. Contributing
- 11. Support
- 12. Documentation
- 13. Reference





