MCP-Undetected-Chromedriver

An MCP service built on undetected-chromedriver, providing a comprehensive interface for automating Chrome browser control while bypassing anti-bot detection.

中文文档

Installation

To install MCP-Undetected-Chromedriver for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @dragons96/mcp-undetected-chromedriver --client claude

Configuration to use Undetected Chromedriver Server

Here’s the Claude Desktop configuration to use the Undetected-chromedriver server:

{
  "mcpServers": {
    "mcp-undetected-chromedriver": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "@dragons96/mcp-undetected-chromedriver",
        "--config",
        "{}"
      ]
    }
  }
}

Requirements

• Python >= 3.11
• Chrome browser

Installation with uv

# Create virtual environment
uv venv

# Activate virtual environment
# Windows
.venv\Scripts\activate
# Linux/MacOS
source .venv/bin/activate

# Install dependencies
uv pip install -e .

Project Introduction

MCP-Undetected-Chromedriver is an MCP (Multi Channel Protocol) service that wraps the functionality of the undetected-chromedriver library into a series of easy-to-use APIs. This project is particularly suitable for scenarios that require bypassing modern website anti-bot detection mechanisms in automated testing, data scraping, or web automation scripts.

Key Features

• Based on undetected-chromedriver, effectively bypassing website anti-bot detection
• Provides rich browser operation API interfaces
• Supports screenshots, PDF export, and other functionalities
• Supports complex page interaction operations such as clicking, form filling, dragging, etc.
• Seamlessly integrates with other tools in the MCP ecosystem

Todo List

• [ ] Optimize browser driver management and handle driver interruptions
• [ ] Extend API capabilities
• [ ] Add more comprehensive error handling and logging
• [ ] Improve documentation with more usage examples
• [ ] Add support for browser profiles and extensions

Usage

Starting the Service

mcp-server-undetected-chromedriver

Available APIs

The service provides the following main API interfaces:

• browser_navigate: Navigate to a specified URL
• browser_screenshot: Take a screenshot of the current page
• browser_click: Click on page elements
• browser_iframe_click: Click on elements within an iframe
• browser_fill: Fill content in input fields
• browser_select: Select options in dropdown selection boxes
• browser_hover: Hover the mouse over elements
• browser_evalute: Execute JavaScript code
• browser_close: Close the browser