Home - JinsongRoh/pydoll-mcp GitHub Wiki
The Ultimate Browser Automation MCP Server
Revolutionary Zero-WebDriver Automation with Intelligent CAPTCHA Bypass
- π Homepage - Project Introduction and Overview
- β‘ Quick Start - Get Started in 5 Minutes
- π₯ Installation Guide - Detailed Installation Instructions
- π§ Configuration - Claude Desktop Integration Setup
- π― Basic Usage - Basic Commands and Examples
- π οΈ Tools Reference - Detailed Description of All Tools
- π Browser Management - Browser Control Methods
- π‘οΈ Security Bypass - CAPTCHA and Security Bypass Features
- π Data Extraction - Web Data Extraction Methods
- π Network Control - Network Monitoring and Control
- π§© PyDoll MCP Server Test Prompt Guide - PyDoll MCP Server Test Prompt Guide
- βοΈ Advanced Configuration - Performance Optimization and Stealth Settings
- π¨ Customization - Custom Settings
- π§© API Reference - Developer API Documentation
- π Script Examples - Real-world Usage Examples
- π Troubleshooting - Common Issues and Solutions
- β FAQ - Frequently Asked Questions
- π¨ Known Issues - Currently Known Issues
- π Support - How to Get Help
- π Changelog - Version Changes
- πΊοΈ Roadmap - Future Development Plans
- π€ Contributing - How to Contribute to the Project
- π Release Notes - Release Notes
PyDoll MCP Server (pydoll-mcp) v1.1.3 is a Model Context Protocol (MCP) server built on the PyDoll library. It enables AI assistants like Claude, OpenAI, and Gemini to naturally control web browsers and perform complex web automation tasks.
- π« Zero WebDriver: Direct browser communication through Chrome DevTools Protocol
- π§ AI-powered CAPTCHA Bypass: Automatic resolution of Cloudflare Turnstile and reCAPTCHA v3
- π€ Human Behavior Simulation: Undetectable interactions that bypass sophisticated anti-bot systems
- β‘ Native Async Architecture: Ultra-fast concurrent automation
- π΅οΈ Advanced Stealth Mode: Anti-detection technology that makes automation undetectable
- π§ One-Click Setup: Automatic Claude Desktop configuration
- π Universal Compatibility: Works on all systems including Korean Windows
- π MCP Protocol Compliance: Resolved JSON parsing issues for stable communication
- π Rich Documentation: Complete user guide and API reference
- Based on Python 3.8+
- Utilizes PyDoll 2.2.1 (2025.06.17) library
- Supports Model Context Protocol (MCP)
- Browser control based on Chrome DevTools Protocol
π Browser Management (8 tools)
- Browser start/stop, tab management, status monitoring, etc.
- URL navigation, page refresh, back/forward navigation, page load waiting, etc.
- Element search, clicking, text input, keyboard input, drag and drop, etc.
- Page/element screenshots, PDF generation, video capture, etc.
- JavaScript execution, script injection, console log monitoring, etc.
- Cloudflare/reCAPTCHA bypass, stealth mode, bot challenge handling, etc.
π Network Control and Monitoring (10 tools)
- Network monitoring, request interception, API response extraction, etc.
- File upload/download, data extraction/export, etc.
- Navigate websites with human-like behavior patterns
- Extract data from protected dynamic websites
- Automate complex workflows across multiple pages
- Seamlessly handle modern SPAs and dynamic content
- Automatically solve Cloudflare Turnstile CAPTCHAs
- Bypass reCAPTCHA v3 without external services
- Evade sophisticated bot detection systems
- Navigate protected content areas
- Scrape data from modern protected websites
- Monitor and capture all network API calls
- Extract information from dynamic, JavaScript-heavy sites
- Handle complex authentication flows
Item | PyDoll MCP | Traditional Tools |
---|---|---|
Setup Time | < 30 seconds | 5-15 minutes |
CAPTCHA Success Rate | 95%+ | 20-30% |
Detection Evasion | 98%+ | 60-70% |
Memory Usage | 50% less | Baseline |
Speed | 3x faster | Baseline |
Reliability | 99%+ | 80-85% |
pip install pydoll-mcp
From v1.1.0, automatic Claude Desktop configuration is provided after installation:
python -m pydoll_mcp.cli auto-setup
Add the following to your Claude Desktop configuration file:
{
"mcpServers": {
"pydoll": {
"command": "python",
"args": ["-m", "pydoll_mcp.server"],
"env": {
"PYDOLL_LOG_LEVEL": "INFO"
}
}
}
}
- β JSON Parsing Error Fixed: Resolved MCP client communication issues
- β Encoding Compatibility: Full support for Korean Windows systems (CP949/EUC-KR)
- β Protocol Compliance: Proper stdout/stderr separation for MCP compatibility
- β Enhanced Stability: Improved server startup and error handling
- Resolved JSON parsing errors
- Korean Windows system support
- Improved MCP protocol compliance
- Enhanced stability and error handling
- Enhanced server stability
- Performance optimization
- Reduced memory usage
- Fixed Korean Windows environment issues
- Improved international compatibility
- Added auto-recovery features
- One-click auto setup feature
- Enhanced CLI tools
- Improved developer experience
- Discussions: Share questions and ideas
- Issues: Bug reports and feature requests
- Contributing: How to contribute to the project
This project is distributed under the MIT License. For details, see the LICENSE file.
Ready to revolutionize browser automation?
Installation Guide |
Quick Start |
API Reference
PyDoll MCP Server - Where AI meets revolutionary browser automation! π€π
PyDoll MCP Server is a next-generation solution that combines AI with revolutionary browser automation, providing a powerful tool that makes complex web automation tasks simple and efficient.