Undetected ChromeDriver

🚀 MCP - Undetected ChromeDriver

A MCP service built on top of undetected-chromedriver, offering comprehensive browser control interfaces for automating Chrome browser operations and bypassing anti-bot detection mechanisms.

Chinese Documentation

🚀 Quick Start

📦 Installation

Automatically install MCP - Undetected ChromeDriver for Claude Desktop via Smithery:

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

⚙️ Configuration

Configure the Undetected Chromedriver server in Claude Desktop as follows:

{
  "mcp": {
    "servers": [
      {
        "id": "undetected-chromedriver",
        "url": "http://localhost:9001"
      }
    ],
    "options": {
      "browser": "chrome",
      "serverId": "undetected-chromedriver"
    }
  }
}

📋 Requirements

• Python Version: Python 3.8 or higher
• Browser: Install the latest version of Chrome browser

📥 Installation Steps

Install using the following command:

pip install mcp-wf

Create and activate a virtual environment (optional):

uv venv
source venv/bin/activate  # On Windows: .venv\Scripts\activate

✨ Features

MCP - Undetected ChromeDriver is a MCP service built on undetected-chromedriver, providing comprehensive browser control interfaces. This service aims to bypass the anti-bot detection mechanisms of modern websites (such as Cloudflare, Distil Networks, etc.) and is suitable for data scraping and automated testing scenarios.

📋 To-Do List

• Support the Firefox browser
• Implement multi-threading support
• Add logging functionality
• Optimize the error handling mechanism

💻 Usage Examples

🌟 Starting the Service

mcp-wf start

📚 Available API Interfaces

🔗 Navigate to a Specified URL

from mcp import client

cli = client.Client()
cli.navigation.goto("https://example.com")

📄 Get Page Content

content = cli.executor.execute("return document.body.innerHTML;")
print(content)

❌ Close the Browser Instance

cli.executor.close()

🔧 Technical Details

This service bypasses anti-bot detection mechanisms through undetected-chromedriver and uses the MCP protocol to provide a series of API interfaces, simplifying the browser operation process.

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for detailed information.

🤝 Contribution Guidelines

Welcome to submit bug reports and feature requests! If you want to contribute code, please discuss your plan with us first.

❓ Frequently Asked Questions (FAQ)

Q: Why choose undetected-chromedriver instead of the standard Selenium Webdriver? A: undetected-chromedriver is specifically designed to bypass the anti-bot detection mechanisms of modern websites, such as Cloudflare and Distil Networks. It is more reliable in 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 the first operation requiring a browser is called. You can use the browser_close API to explicitly close the browser.

Q: How to handle elements in iframes? A: The browser_iframe_click API can directly operate on elements within iframes without manually switching the frame context.