Skip to main content
Glama
Sign In
enesjakozh

MCP-Undetected-Chromedriver

by dragons96
GitHub
Python
MIT License
2
  • Linux
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Provides a wrapper around undetected-chromedriver (a Selenium variant) for bypassing anti-bot detection while automating web browsing tasks, including navigation, screenshots, form filling, and page interaction.

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
  • browser_get_visible_text: Get visible text on the page
  • browser_get_visible_html: Get visible HTML on the page
  • browser_go_back: Navigate backward in browser history
  • browser_go_forward: Navigate forward in browser history
  • browser_drag: Drag elements
  • browser_press_key: Simulate key presses
  • browser_save_as_pdf: Save the page as a PDF

Code Example

from mcp.client import Client # Create MCP client client = Client() client.start("undetected-chromedriver-mcp-server") # Navigate to website response = client.call("browser_navigate", {"url": "https://example.com"}) print(response) # Take a screenshot response = client.call("browser_screenshot", {"name": "example"}) print(response) # Get page text response = client.call("browser_get_visible_text") print(response.content[0].text) # Close the browser client.call("browser_close")

How It Works

This service uses the undetected-chromedriver library to create a specialized Chrome browser instance that effectively evades common anti-bot detection mechanisms. The service wraps these features through the MCP protocol, providing an easy-to-use API interface that makes automated testing and web scraping more convenient.

License

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

Contribution Guidelines

Bug reports and feature requests are welcome on the GitHub Issues page. If you want to contribute code, please create an issue to discuss your ideas first.

FAQ

Q: Why choose undetected-chromedriver instead of the standard selenium webdriver?

A: undetected-chromedriver is specifically designed to bypass anti-bot detection mechanisms of modern websites, such as Cloudflare, Distil Networks, etc., making it more reliable for data scraping and automated testing scenarios.

Q: How does the service handle browser instances?

A: The service maintains a global browser instance, which is automatically created when an API requiring a browser is first called. The browser can be explicitly closed using the browser_close API.

Q: How to handle elements within iframes?

A: The browser_iframe_click API can directly operate on elements within iframes, without the need to manually switch frame contexts.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

An MCP service that automates Chrome browser control while bypassing anti-bot detection mechanisms, enabling web scraping, testing and automation on sites with sophisticated bot protection.

  1. Installation
    1. Configuration to use Undetected Chromedriver Server
      1. Requirements
      2. Installation with uv
    2. Project Introduction
      1. Key Features
    3. Todo List
      1. Usage
        1. Starting the Service
        2. Available APIs
        3. Code Example
      2. How It Works
        1. License
          1. Contribution Guidelines
            1. FAQ

              Related Resources

              ID: iglw7qg4kz