### PyDoll MCP Quick Start Options

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/README.md

Presents the initial options presented after a successful PyDoll MCP installation, guiding the user through setup choices like auto-configuration, manual configuration, testing, or skipping setup.

```Bash
python -m pydoll_mcp.cli auto-setup
```

--------------------------------

### Run Interactive Setup

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Installation-Guide

Initiates an interactive, step-by-step setup guide for PyDoll MCP Server via the command line.

```bash
# Step-by-step setup guide
python -m pydoll_mcp.cli quick-start
```

--------------------------------

### Install PyDoll MCP Server

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Quick-Start

Installs the PyDoll MCP Server using pip. This is the recommended one-click installation method to get started quickly.

```bash
pip install pydoll-mcp
```

--------------------------------

### Run Interactive PyDoll MCP Quick Start Guide

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Configuration

Executes the interactive quick start guide for PyDoll MCP Server via the command-line interface, assisting users through the setup process.

```bash
# Run interactive setup guide
python -m pydoll_mcp.cli quick-start
```

--------------------------------

### PyDoll MCP Quick Start

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/README.md

Initiate the interactive setup guide for PyDoll MCP using the CLI command.

```bash
# Interactive setup guide
python -m pydoll_mcp.cli quick-start
```

--------------------------------

### Run PyDoll MCP Server Auto Setup

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Quick-Start

Executes the auto-setup command for PyDoll MCP Server. This command verifies the installation, locates Claude Desktop configuration, backs up existing settings, adds PyDoll MCP Server configuration, and confirms the configuration's validity.

```bash
python -m pydoll_mcp.cli auto-setup
```

--------------------------------

### Development Installation from Source

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Installation-Guide

Guides through installing PyDoll MCP Server from its source code. Includes cloning the repository, setting up a virtual environment, installing dependencies, and installing the package in development mode.

```bash
# Clone repository
git clone https://github.com/JinsongRoh/pydoll-mcp.git
cd pydoll-mcp

# Create virtual environment (recommended)
python -m venv venv

# Activate virtual environment
# Windows:
virtualenv\Scripts\activate
# Linux/macOS:
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Install in development mode
pip install -e .
```

--------------------------------

### PyDoll MCP Server Quick Start CLI

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Release-Notes

Initiate an interactive guided setup for beginners using the PyDoll MCP Server CLI. This command provides a user-friendly experience for initial configuration.

```Python
python -m pydoll_mcp.cli quick-start
```

--------------------------------

### Test PyDoll MCP Server Installation

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Quick-Start

Tests the installation of the PyDoll MCP Server with verbose output. It checks the Python version, installed packages, detected browser, MCP server startup capability, and overall test results.

```bash
python -m pydoll_mcp.cli test-installation --verbose
```

--------------------------------

### Quick Start Installation (Bash)

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/release-notes/RELEASE_NOTES_v1.0.0.md

The primary command to install PyDoll MCP Server using pip from GitHub, as part of the quick start guide.

```bash
pip install git+https://github.com/JinsongRoh/pydoll-mcp.git
```

--------------------------------

### Clone PyDoll MCP Repository and Setup Development Environment

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/README.md

Guides through cloning the PyDoll MCP repository, setting up a virtual environment, installing development dependencies, and running tests.

```bash
git clone https://github.com/JinsongRoh/pydoll-mcp.git
cd pydoll-mcp

python -m venv venv
source venv/bin/activate

pip install -e ".[dev]"

python -m pytest tests/ -v

pre-commit install
```

--------------------------------

### Run One-Click Auto Setup

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Installation-Guide

Executes an automated setup script for PyDoll MCP Server after installation. This script verifies installation, checks configuration file locations, backs up existing configurations, adds PyDoll MCP Server configuration, and confirms it works.

```bash
# Run auto setup after installation
python -m pydoll_mcp.cli auto-setup
```

--------------------------------

### PyDoll MCP Alternative Setup: Manual Setup from Source

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/README.md

Installs PyDoll MCP by cloning the repository from GitHub, installing dependencies, and setting it up in development mode. This method is useful for developers who want to modify the source code.

```Bash
git clone https://github.com/JinsongRoh/pydoll-mcp.git
cd pydoll-mcp
pip install -r requirements.txt
pip install -e .
python -m pydoll_mcp.cli setup-claude
```

--------------------------------

### PyDoll MCP Server Configuration File Content

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Installation-Guide

Example JSON content for the Claude Desktop configuration file, specifying how to integrate PyDoll MCP Server with its command, arguments, and environment variables.

```json
{
  "mcpServers": {
    "pydoll": {
      "command": "python",
      "args": ["-m", "pydoll_mcp.server"],
      "env": {
        "PYDOLL_LOG_LEVEL": "INFO",
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}
```

--------------------------------

### Force PyDoll MCP Server Auto Setup

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Quick-Start

Forces the auto-setup process for PyDoll MCP Server, potentially regenerating the configuration. This is useful for resolving configuration-related problems.

```bash
python -m pydoll_mcp.cli auto-setup --force
```

--------------------------------

### Set Up PyDoll MCP Development Environment

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Installation-Guide

Commands to install PyDoll MCP with development and testing dependencies, including installing all optional dependencies.

```bash
pip install "pydoll-mcp[dev]"
```

```bash
pip install "pydoll-mcp[test]"
```

```bash
pip install "pydoll-mcp[dev,test]"
```

--------------------------------

### Windows Auto Setup Script

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Installation-Guide

Downloads and executes a batch script for automating the setup process on Windows, likely configuring Claude Desktop with PyDoll MCP Server.

```batch
# Download and run setup script
curl -o setup_claude.bat https://raw.githubusercontent.com/JinsongRoh/pydoll-mcp/main/setup/setup_claude_windows.bat
setup_claude.bat
```

--------------------------------

### Install from Production PyPI

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/README_PYPI_DEPLOYMENT.md

This command installs the package from the production PyPI repository, making it available for end-users to install and use.

```bash
pip install pydoll-mcp
```

--------------------------------

### Run PyDoll MCP Server Quick Start

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/FAQ

Initiates the interactive quick-start guide for PyDoll MCP Server.

```python
python -m pydoll_mcp.cli quick-start
```

--------------------------------

### Install PyDoll MCP Package

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/SMITHERY_DEPLOYMENT.md

Installs the PyDoll MCP server package from PyPI using pip. This command is used for manual setup or integration.

```python
pip install pydoll-mcp
```

--------------------------------

### Linux/macOS Auto Setup Script

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Installation-Guide

Downloads and executes a shell script for automating the setup process on Linux or macOS, likely configuring Claude Desktop with PyDoll MCP Server.

```bash
# Download and run setup script
curl -o setup_claude.sh https://raw.githubusercontent.com/JinsongRoh/pydoll-mcp/main/setup/setup_claude_unix.sh
chmod +x setup_claude.sh
./setup_claude.sh
```

--------------------------------

### Start Basic Chrome Browser

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Browser-Management

Initiates a standard Chrome browser instance. This is the simplest way to start a browser.

```Natural Language
Please start the browser
```

--------------------------------

### Install PyDoll MCP Server from Source

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/INSTALLATION_GUIDE.md

Installs the PyDoll MCP Server from its source code repository. This method involves cloning the repository, setting up a virtual environment, installing dependencies, and installing the package in development mode. Includes verification.

```bash
# Clone the repository
git clone https://github.com/JinsongRoh/pydoll-mcp.git
cd pydoll-mcp

# Create virtual environment (recommended)
python -m venv venv

# Activate virtual environment
# Windows:
virtual\Scripts\activate
# macOS/Linux:
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Install in development mode
pip install -e .

# Verify installation
python -m pydoll_mcp.server --test
```

--------------------------------

### Install Documentation Dependencies and Serve

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/CONTRIBUTING.md

Installs the necessary packages for documentation and starts a local server to view the built documentation. This is typically used for development and previewing documentation changes.

```bash
pip install -e ".[docs]"

mkdocs serve

# View at http://localhost:8000
```

--------------------------------

### Docker Installation

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Installation-Guide

Demonstrates how to install and run PyDoll MCP Server using Docker. Includes commands to pull the image, run a container, check its status, and view logs.

```bash
# Download and run Docker image
docker run -d --name pydoll-mcp -p 8080:8080 jinsongroh/pydoll-mcp:latest

# Check container status
docker ps

# View container logs
docker logs pydoll-mcp
```

--------------------------------

### Troubleshoot PyDoll MCP Server Browser Startup Failures

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Support

This section offers solutions for issues where the browser fails to start with PyDoll MCP Server. It includes commands to check browser installation, test basic functionality, and verify file permissions on Linux systems.

```bash
# Check browser installation
python -c "from pydoll.browser import Chrome; print('Browser check complete')"
```

```bash
# Test basic functionality
python -m pydoll_mcp.cli test-browser
```

```bash
# Check permissions (Linux)
ls -la /usr/bin/google-chrome
```

--------------------------------

### PyDoll MCP Server Setup Entry Point

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Release-Notes

Execute the dedicated setup entry point for PyDoll MCP Server. This command serves as a primary interface for initiating the installation and configuration.

```Python
pydoll-mcp-setup
```

--------------------------------

### Install from TestPyPI

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/README_PYPI_DEPLOYMENT.md

This command installs the package from the TestPyPI repository, allowing you to test its functionality and installation process without affecting the production environment.

```bash
pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ pydoll-mcp
```

--------------------------------

### Practical Example: Online Shopping Automation

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Basic-Usage

An example demonstrating a multi-step automation process for an online shopping scenario, including searching, clicking, capturing information, and adding to cart.

```Claude Desktop Commands
"Please access the shopping site and:
1. Search for 'laptop' in the search box
2. Click on the first product
3. Capture the product information
4. Add to cart"
```

--------------------------------

### Verify PyDoll MCP Server Integration

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Configuration

This section provides example commands to verify the PyDoll MCP Server's integration with Claude Desktop. It suggests actions like starting a browser, taking screenshots, and checking server status.

```python
"Start a browser and navigate to example.com"
"Take a screenshot of the current page"
"Check PyDoll MCP Server status"
```

--------------------------------

### PyDoll MCP Alternative Setup: Auto Setup

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/README.md

Installs PyDoll MCP and automatically configures Claude Desktop. This is a convenient option for users who want a quick and seamless setup process.

```Bash
pip install pydoll-mcp
python -m pydoll_mcp.cli auto-setup
```

--------------------------------

### Set Up PyDoll MCP Virtual Environment

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Installation-Guide

Steps to create, activate, and install PyDoll MCP within a Python virtual environment on Windows, Linux, and macOS.

```bash
python -m venv pydoll-env
```

```bash
# Windows:
pydoll-env\Scripts\activate
# Linux/macOS:
source pydoll-env/bin/activate
```

```bash
pip install pydoll-mcp
```

--------------------------------

### One-Click Setup and Enhanced CLI

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/README.md

This snippet highlights features for one-click setup, including automatic Claude Desktop configuration during pip installation, and enhanced CLI commands for setup, testing, and configuration.

```Python
# Automatic Claude Desktop configuration on pip install
# New CLI commands for setup, testing, and configuration
```

--------------------------------

### Practical Example: News Site Monitoring Automation

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Basic-Usage

An example illustrating automation for news site monitoring, involving taking screenshots, navigating categories, collecting titles, and extracting article content.

```Claude Desktop Commands
"On the news site:
1. Take a screenshot of the main page
2. Navigate to the 'Technology' category
3. Collect the latest article titles
4. Get the full text of the first article"
```

--------------------------------

### Navigate and Screenshot Website

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Script-Examples

This example demonstrates basic website navigation and capturing screenshots. It involves starting a browser, navigating to a URL, and taking a full-page screenshot. Dependencies include browser instance creation and page load waiting.

```plaintext
"Start a browser and navigate to https://example.com"
"Take a screenshot of the current page"
"Check the page title"
```

--------------------------------

### PyDoll MCP Server Configuration File

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/INSTALLATION_GUIDE.md

Example JSON configuration file for PyDoll MCP Server, allowing persistent settings for browser behavior, automation, captcha handling, and network options. This file should be placed at `~/.pydoll/config.json`.

```json
{
  "browser": {
    "type": "chrome",
    "headless": false,
    "window_size": [1920, 1080],
    "stealth_mode": true
  },
  "automation": {
    "timeout": 30,
    "retry_attempts": 3,
    "human_behavior": true
  },
  "captcha": {
    "auto_solve": true,
    "cloudflare_bypass": true,
    "recaptcha_bypass": true
  },
  "network": {
    "monitor_requests": true,
    "block_ads": true,
    "enable_cache": true
  }
}
```

--------------------------------

### Install Pre-commit Hooks

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Support

Installs the pre-commit hooks for the project. This ensures that code adheres to project standards before committing.

```Shell
pre-commit install
```

--------------------------------

### Create Clean Virtual Environment for PyDoll

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/INSTALLATION_GUIDE.md

Steps to create and activate a new virtual environment using Python's `venv` module, ensuring a clean slate for installing PyDoll and its dependencies.

```bash
# Create clean virtual environment
python -m venv clean_env
source clean_env/bin/activate  # macOS/Linux
clean_env\Scripts\activate   # Windows

# Install fresh
pip install pydoll-mcp
```

--------------------------------

### Install PyDoll MCP with Alternative Index

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/INSTALLATION_GUIDE.md

Installs the PyDoll MCP package from an alternative PyPI index, which can be useful for bypassing network restrictions or using specific package sources.

```bash
# Install with different index
pip install -i https://pypi.org/simple/ pydoll-mcp

# Use proxy if needed
pip install --proxy http://proxy:port pydoll-mcp
```

--------------------------------

### Install Smithery CLI

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/SMITHERY_DEPLOYMENT.md

Installs the Smithery CLI tool globally using either npm or yarn. This is a prerequisite for interacting with the Smithery platform for deployment.

```bash
npm install -g @smithery/cli
```

```bash
yarn global add @smithery/cli
```

--------------------------------

### Documenting Environment Variables in README

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/ENVIRONMENT_VARIABLES_GUIDE.md

Provides an example of how to document required environment variables in a README file, including descriptions and example commands.

```markdown
## Configuration

Set the following environment variables:

- `PYPI_TOKEN` - Your PyPI API token (get from https://pypi.org/manage/account/token/)
- `SMITHERY_KEY` - Smithery.ai API key (optional)

Example:
```bash
export PYPI_TOKEN=pypi-YOUR_TOKEN_HERE
```
```

--------------------------------

### Troubleshooting: Test Server Functionality

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/DEPLOYMENT_GUIDE.md

Command to test the server's installation and basic functionality.

```bash
# Test server functionality
python -m pydoll_mcp.cli test-installation
```

--------------------------------

### Manage PyDoll MCP Server Versions

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/INSTALLATION_GUIDE.md

Provides commands for managing PyDoll MCP Server versions using pip. Includes checking the current version, installing a specific version, and listing available versions from the index.

```bash
# Check current version
pydoll-mcp --version

# Install specific version
pip install pydoll-mcp==1.0.0

# List available versions
pip index versions pydoll-mcp
```

--------------------------------

### Install PyDoll MCP via Pip

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/README.md

Installs the PyDoll MCP package using pip, the standard Python package installer. This is the recommended and simplest method for getting started.

```Bash
pip install pydoll-mcp
```

--------------------------------

### Diagnose PyDoll MCP Server Installation and Status

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Support

These commands help diagnose the installation status, browser compatibility, and server status of the PyDoll MCP Server. The `--verbose` flag provides detailed output for installation checks, while `--logs` and `--stats` offer insights into server performance.

```bash
python -m pydoll_mcp.cli test-installation --verbose
```

```bash
python -m pydoll_mcp.cli test-browser --browser chrome
```

```bash
python -m pydoll_mcp.cli status --logs --stats
```

```bash
python -m pydoll_mcp.server --test
```

--------------------------------

### Start PyDoll MCP Server

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Configuration

This snippet shows how to start the PyDoll MCP server, including setting the Python IO encoding to UTF-8 and using a UTF-8 command prompt for proper character handling.

```bash
set PYTHONIOENCODING=utf-8
python -m pydoll_mcp.server
```

```bash
# Use UTF-8 command prompt
chcp 65001
python -m pydoll_mcp.server
```

--------------------------------

### Basic Website Navigation Example

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/API-Reference

Demonstrates basic browser automation tasks such as starting a browser, navigating to a URL, taking screenshots, and performing searches.

```bash
"Start a browser and navigate to https://example.com"
"Take a screenshot of the current page"
"Find the search box and search for 'browser automation'"
```

--------------------------------

### Contribute to PyDoll MCP Server Project

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Support

Instructions for contributing to the PyDoll MCP Server project. This includes forking and cloning the repository, setting up a development environment, installing dependencies, and running tests.

```bash
# Fork and clone repository
git clone https://github.com/JinsongRoh/pydoll-mcp.git
cd pydoll-mcp
```

```bash
# Set up development environment
python -m venv venv
source venv/bin/activate  # Linux/macOS
# or venv\Scripts\activate  # Windows
```

```bash
# Install development dependencies
pip install -e ".[dev]"
```

```bash
# Run tests
python -m pytest tests/ -v
```

--------------------------------

### Bash: Run Unified Setup Command

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/release-notes/RELEASE_NOTES_v1.3.0.md

This bash command executes the new unified setup utility for PyDoll MCP Server. It automates OS detection, backup creation, configuration validation, and Python path optimization, simplifying the installation and configuration process.

```Bash
# Run the new unified setup
pydoll-mcp-setup
```

--------------------------------

### Smithery.ai Registry Update Payload

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/DEPLOYMENT_GUIDE.md

Example JSON payload for updating the Smithery.ai MCP registry, detailing package name, description, version, installation, configuration, and capabilities.

```json
{
  "name": "pydoll-mcp",
  "description": "Revolutionary browser automation MCP server...",
  "version": "X.X.X",
  "installation": {
    "type": "pip",
    "package": "pydoll-mcp"
  },
  "configuration": {
    "command": "python",
    "args": ["-m", "pydoll_mcp.server"],
    "env": {
      "PYDOLL_LOG_LEVEL": "INFO"
    }
  },
  "capabilities": {
    "browser_automation": true,
    "captcha_bypass": true,
    "stealth_mode": true,
    "// ... more capabilities": ""
  }
}
```

--------------------------------

### Docker Compose Service Management

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Installation-Guide

Commands to manage the PyDoll MCP Server service using Docker Compose, including starting the service in detached mode and checking its status.

```bash
# Start service
docker-compose up -d

# Check status
docker-compose ps
```

--------------------------------

### Start Chrome Browser Headless

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Browser-Management

Initiates a Chrome browser instance in headless mode with image loading disabled for optimized scraping. This setup is crucial for efficient background processing.

```python
from pydoll import Doll

doll = Doll(headless=True, disable_images=True)
doll.start()
```

--------------------------------

### Avoid Committing Secrets Directly in YAML

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/SECURITY_SETUP.md

Illustrates a common security mistake: hardcoding sensitive tokens or keys directly within the workflow YAML file. This example shows what NOT to do.

```yaml
# DON'T DO THIS!
env:
  PYPI_TOKEN: <your-pypi-token-here>
  SMITHERY_KEY: sk-1234567890abcdef...
```

--------------------------------

### Check PyDoll MCP Server Installation and List Tools

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/PyDoll-MCP-Test-Prompts-EN.md

Verify the PyDoll MCP server connection and list all available browser automation tools. This is a foundational step for testing.

```text
Please verify that the PyDoll MCP server is properly connected. List all available browser automation tools.
```

--------------------------------

### macOS/Linux Automatic Setup for Claude Desktop

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/INSTALLATION_GUIDE.md

A bash script to automatically configure PyDoll MCP Server for Claude Desktop on macOS and Linux. It creates the necessary configuration directory and a JSON file for server settings.

```bash
#!/bin/bash
echo "Setting up PyDoll MCP Server for Claude Desktop..."

# Determine the configuration directory
if [[ "$OSTYPE" == "darwin"* ]]; then
    CONFIG_DIR="$HOME/Library/Application Support/Claude"
else
    CONFIG_DIR="$HOME/.config/Claude"
fi

# Create configuration directory
mkdir -p "$CONFIG_DIR"

```

--------------------------------

### PyDoll MCP Server Installation and Auto Setup

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Release-Notes

Install the PyDoll MCP Server package and trigger the automatic setup process. This command ensures a smooth post-installation configuration.

```Bash
pip install pydoll-mcp
python -m pydoll_mcp.cli auto-setup
```

--------------------------------

### Test Browser Automation with PyDoll

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/INSTALLATION_GUIDE.md

An asynchronous Python script to test PyDoll's browser automation capabilities. It launches a Chrome instance, navigates to example.com, and retrieves the page title.

```python
import asyncio
from pydoll.browser import Chrome

async def test():
    try:
        async with Chrome() as browser:
            tab = await browser.start()
            await tab.go_to('https://example.com')
            title = await tab.get_title()
            print(f'✅ Browser test successful: {title}')
    except Exception as e:
        print(f'❌ Browser test failed: {e}')

asyncio.run(test())
```

--------------------------------

### Configure PyPI Access with .pypirc

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/README_PYPI_DEPLOYMENT.md

This snippet shows how to copy an example .pypirc file and edit it to include your PyPI API tokens for authentication. It's crucial for uploading packages to PyPI.

```bash
# Copy the example file
cp .pypirc.example ~/.pypirc

# Edit the file and add your tokens
nano ~/.pypirc
```

--------------------------------

### Test Network Connectivity with Python

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/INSTALLATION_GUIDE.md

Tests network connectivity by making an HTTP GET request to httpbin.org using aiohttp and asyncio. It prints the status code and a success message if the request is successful. This snippet requires the 'aiohttp' and 'asyncio' libraries.

```bash
# Test network connectivity
python -c "
import aiohttp
import asyncio

async def test_network():
    async with aiohttp.ClientSession() as session:
        async with session.get('https://httpbin.org/get') as resp:
            print(f'Status: {resp.status}')
            print('✅ Network connectivity OK')

asyncio.run(test_network())
"
```

--------------------------------

### Create and Activate Python Virtual Environment

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/FAQ

Guides through creating a Python virtual environment, activating it on different operating systems, and installing PyDoll MCP.

```bash
# Create virtual environment
python -m venv pydoll-env

# Activate (Windows)
pydoll-env\Scripts\activate

# Activate (Linux/macOS)  
source pydoll-env/bin/activate

# Install
pip install pydoll-mcp
```

--------------------------------

### Troubleshoot pip Upgrade and Installation

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Installation-Guide

Instructions for upgrading pip and performing a detailed installation of pydoll-mcp, including verbose logging.

```bash
python -m pip install --upgrade pip
```

```bash
pip install pydoll-mcp -v
```

--------------------------------

### Windows Automatic Setup for Claude Desktop

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/INSTALLATION_GUIDE.md

A batch script to automatically configure PyDoll MCP Server for Claude Desktop on Windows. It creates a configuration directory and a JSON file with server command and environment variables. Requires administrator privileges.

```batch
@echo off
echo Setting up PyDoll MCP Server for Claude Desktop...

# Create the configuration directory
if not exist "%APPDATA%\Claude" mkdir "%APPDATA%\Claude"

# Create claude_desktop_config.json
echo { echo   "mcpServers": { echo     "pydoll": { echo       "command": "python", echo       "args": ["-m", "pydoll_mcp.server"], echo       "env": { echo         "PYDOLL_LOG_LEVEL": "INFO", echo         "PYDOLL_BROWSER_TYPE": "chrome" echo       } echo     } echo   } echo }
> "%APPDATA%\Claude\claude_desktop_config.json"

echo Claude Desktop configuration updated!
echo Please restart Claude Desktop to activate PyDoll MCP Server.
pause
```

--------------------------------

### Install PyDoll MCP Server via pip (Linux CentOS/RHEL)

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Installation-Guide

Installs the PyDoll MCP Server on CentOS/RHEL Linux using pip. It covers enabling the EPEL repository, installing pip, and verifying the installation.

```bash
# Enable EPEL repository
sudo yum install epel-release

# Install Python pip
sudo yum install python3-pip

# Install PyDoll MCP Server
pip3 install pydoll-mcp

# Verify installation
pydoll-mcp --version
python3 -m pydoll_mcp.server --test
```

--------------------------------

### Set Up PyDoll MCP Development Environment

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Contributing

Steps to set up a Python virtual environment, activate it, and install project dependencies, including development-specific packages.

```bash
# Create virtual environment
python -m venv venv
source venv/bin/activate  # Linux/macOS
virtualenv\Scripts\activate   # Windows

# Install dependencies
pip install -r requirements.txt
pip install -e ".[dev]"
```

--------------------------------

### PyDoll MCP Server Command Examples (After v1.5.7)

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/release-notes/RELEASE_NOTES_v1.5.7.md

Demonstrates the corrected command-line usage of PyDoll MCP Server after version 1.5.7, showing successful browser startup and navigation operations.

```bash
# Browser startup
pydoll-mcp start_browser  # ✅ Works correctly
# Tab creation
new_tab browser_123       # ✅ Creates tab successfully  
# Navigation
navigate_to browser_123 tab_456 "https://google.com"  # ✅ Navigation works
```

--------------------------------

### Install PyDoll MCP Server via pip (Linux Ubuntu/Debian)

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Installation-Guide

Installs the PyDoll MCP Server on Ubuntu/Debian Linux using pip. It includes steps to update system packages, install pip if necessary, and verify the installation.

```bash
# Update system packages
sudo apt update

# Install Python pip (if needed)
sudo apt install python3-pip

# Install PyDoll MCP Server
pip3 install pydoll-mcp

# Verify installation
pydoll-mcp --version
python3 -m pydoll_mcp.server --test
```

--------------------------------

### Publish to PyPI using GitHub Actions

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/SECURITY_SETUP.md

Demonstrates how to use the `pypa/gh-action-pypi-publish` action to publish a package to PyPI, utilizing the `PYPI_API_TOKEN` secret for authentication.

```yaml
- name: Publish to PyPI
  uses: pypa/gh-action-pypi-publish@release/v1
  with:
    password: ${{ secrets.PYPI_API_TOKEN }}
```

--------------------------------

### Install and Auto-Setup PyDoll MCP Server

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Configuration

Installs the PyDoll MCP Server via pip and initiates the automatic setup process for Claude Desktop integration. This is the recommended method for versions 1.1.0 and above.

```bash
pip install pydoll-mcp
python -m pydoll_mcp.cli auto-setup
```

--------------------------------

### PyDoll MCP Manual Setup: Windows Script

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/README.md

Downloads and executes a batch script for manual setup of Claude Desktop on Windows. This script automates the configuration process for Windows users.

```Batch
curl -o setup_claude.bat https://raw.githubusercontent.com/JinsongRoh/pydoll-mcp/main/setup/setup_claude_windows.bat
setup_claude.bat
```

--------------------------------

### Check Python Version

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/INSTALLATION_GUIDE.md

Command to display the currently installed Python version. Includes guidance on installing newer versions if the current one is incompatible.

```bash
# Check Python version
python --version

# If version is < 3.8, install newer Python:
# Windows: Download from python.org
# macOS: brew install python@3.11
# Linux: sudo apt install python3.11
```

--------------------------------

### Install PyDoll MCP Server via pip (Linux CentOS/RHEL/Fedora)

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/INSTALLATION_GUIDE.md

Installs the PyDoll MCP Server using pip on CentOS/RHEL/Fedora Linux. Includes commands to update the package manager and install pip, followed by installation and verification steps.

```bash
# Update package manager
sudo yum update  # CentOS/RHEL
sudo dnf update  # Fedora

# Install Python pip
sudo yum install python3-pip  # CentOS/RHEL
sudo dnf install python3-pip  # Fedora

# Install PyDoll MCP Server
pip3 install pydoll-mcp

# Verify installation
pydoll-mcp --version
python3 -m pydoll_mcp.server --test
```

--------------------------------

### Install PyDoll MCP Server via pip (Windows)

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Installation-Guide

Installs the PyDoll MCP Server using pip in a Windows Command Prompt or PowerShell. It also includes a command to verify the installation and test the server.

```cmd
# Run Command Prompt or PowerShell as Administrator
# Install PyDoll MCP Server
pip install pydoll-mcp

# Verify installation
pydoll-mcp --version
python -m pydoll_mcp.server --test
```

--------------------------------

### PyDoll MCP Installation Verification

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Installation-Guide

Commands to perform basic and detailed tests for PyDoll MCP installation, including checking the installation, browser functionality, server status, Python version, package integrity, and MCP server tests.

```bash
python -m pydoll_mcp.cli test-installation --verbose
```

```bash
python -m pydoll_mcp.cli test-browser --browser chrome --headless
```

```bash
python -m pydoll_mcp.cli status --logs --stats
```

```bash
python --version
```

```bash
pip show pydoll-mcp
```

```python
from pydoll.browser import Chrome; print('Chrome detection successful')
```

```bash
python -m pydoll_mcp.server --test
```

--------------------------------

### Testing PyPI Deployment via Git Tag

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/PYPI_TRUSTED_PUBLISHER_SETUP.md

This section provides the necessary Git commands to create and push a new tag, which triggers the GitHub Actions workflow for testing the PyPI deployment. It's a common practice for versioning and releasing packages.

```Bash
# 1. Create a new tag (e.g., version 1.5.16)
git tag v1.5.16

# 2. Push the tag to the remote repository
git push origin v1.5.16
```

--------------------------------

### Download and Run Linux/macOS Auto Setup Script for Claude

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Configuration

Downloads the `setup_claude_unix.sh` script using curl, makes it executable with chmod, and then runs it to automate Claude Desktop integration setup on Linux and macOS.

```bash
# Download and run setup script
curl -o setup_claude.sh https://raw.githubusercontent.com/JinsongRoh/pydoll-mcp/main/setup/setup_claude_unix.sh
chmod +x setup_claude.sh
./setup_claude.sh
```

--------------------------------

### Pydoll-MCP CLI: Configuration Validation and Testing

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Customization

Shows Pydoll-MCP CLI commands for checking configuration status, testing browser connectivity, and validating the installation with verbose output.

```bash
# Check configuration status
python -m pydoll_mcp.cli status --logs --stats

# Test browser
python -m pydoll_mcp.cli test-browser --browser chrome --headless

# Validate installation
python -m pydoll_mcp.cli test-installation --verbose
```

--------------------------------

### Install Google Chrome Browser

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/INSTALLATION_GUIDE.md

Provides instructions for installing Google Chrome on different operating systems (Windows, macOS, Linux) to ensure browser automation compatibility with PyDoll.

```bash
# Install Chrome
# Windows: Download from google.com/chrome
# macOS: brew install --cask google-chrome
# Linux: sudo apt install google-chrome-stable

# Or install Edge
# Windows: Usually pre-installed
# macOS: Download from microsoft.com/edge
# Linux: See Microsoft Edge Linux installation guide
```

--------------------------------

### Download and Run Windows Auto Setup Script for Claude

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Configuration

Downloads the `setup_claude_windows.bat` script using curl and then executes it to automate the setup process for Claude Desktop integration on Windows.

```batch
# Download and run setup script
curl -o setup_claude.bat https://raw.githubusercontent.com/JinsongRoh/pydoll-mcp/main/setup/setup_claude_windows.bat
setup_claude.bat
```

--------------------------------

### Install PyDoll MCP Server via pip (Linux Ubuntu/Debian)

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/INSTALLATION_GUIDE.md

Installs the PyDoll MCP Server using pip on Ubuntu/Debian Linux. Includes steps to update the package manager, install pip and venv if needed, and offers an alternative for user-specific installation. Verification commands are provided.

```bash
# Update package manager
sudo apt update

# Install Python pip if not already installed
sudo apt install python3-pip python3-venv

# Install PyDoll MCP Server
pip3 install pydoll-mcp

# Alternative: Install in user directory
pip3 install --user pydoll-mcp

# Verify installation
pydoll-mcp --version
python3 -m pydoll_mcp.server --test
```

--------------------------------

### Install PyDoll MCP Server via pip (macOS)

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Installation-Guide

Installs the PyDoll MCP Server using pip in a macOS Terminal. It provides commands for standard installation and addresses potential permission issues with `--user`. Includes verification steps.

```bash
# Open Terminal
# Install PyDoll MCP Server
pip install pydoll-mcp

# If permission issues occur:
pip install --user pydoll-mcp

# Verify installation
pydoll-mcp --version
python -m pydoll_mcp.server --test
```

--------------------------------

### Start Browser with Proxy Configuration

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/FAQ

Python code snippet demonstrating how to instruct an AI to start a browser using a specified proxy server. This is useful for network testing and privacy.

```python
"Start browser with proxy server 127.0.0.1:8080"
```

--------------------------------

### Upgrade Pip for PyDoll Installation

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Troubleshooting

Ensure pip is up-to-date to avoid installation failures with PyDoll MCP Server. Includes commands to upgrade pip and retry the installation, with an option for verbose logging.

```bash
python -m pip install --upgrade pip
```

```bash
pip install pydoll-mcp
```

```bash
pip install pydoll-mcp -v
```

--------------------------------

### Install PyDoll MCP Server

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/FAQ

Installs the PyDoll MCP Server using pip. After installation, auto-setup options will be presented.

```bash
pip install pydoll-mcp
```

--------------------------------

### Install PyDoll MCP with User Permissions

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/INSTALLATION_GUIDE.md

Installs the PyDoll MCP package using pip, specifying the `--user` flag to avoid permission errors, particularly on macOS and Linux systems.

```bash
# Windows: Run Command Prompt as Administrator
# macOS/Linux: Use sudo or install in user directory
pip install --user pydoll-mcp
```

--------------------------------

### Start Browser with Advanced Settings

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Browser-Management

Launches a browser with specific configurations such as headless mode and custom window dimensions. Supports various options like stealth mode, proxy, user agent, and ad blocking.

```Natural Language
Please start Chrome browser in headless mode
and set window size to 1280x720
```

```Natural Language
Please start headless Chrome browser with image loading disabled and ad blocking enabled
```

```Natural Language
Please start Edge browser with stealth mode disabled and window size set to 800x600
```

--------------------------------

### Manage Browser Startup and Status

Source: https://github.com/jinsongroh/pydoll-mcp/blob/main/PyDoll-MCP-Test-Prompts-EN.md

Start a new Chrome browser instance and check the status of all currently active browsers. This tests basic browser lifecycle management.

```text
Start a new Chrome browser and check the status of all currently running browsers.
```

--------------------------------

### Run PyDoll MCP Server Auto Setup

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/FAQ

Executes the auto-setup command for PyDoll MCP Server, which configures Claude Desktop and verifies the installation.

```python
python -m pydoll_mcp.cli auto-setup
```

--------------------------------

### Install PyDoll MCP

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Home

Installs the PyDoll MCP package using pip. This is the primary method for getting the library into your Python environment.

```bash
pip install pydoll-mcp
```

--------------------------------

### Troubleshoot PyDoll MCP Installation Issues

Source: https://github.com/jinsongroh/pydoll-mcp/wiki/Configuration

Offers solutions for common installation problems, including checking Python version compatibility (3.8+), upgrading pip, and performing a verbose installation.

```bash
# Check Python version (3.8+ required)
python --version

# Upgrade pip
python -m pip install --upgrade pip

# Install with verbose output
pip install pydoll-mcp -v
```