camoufox-mcp

# Camoufox MCP Server A Python MCP (Model Context Protocol) server providing full browser automation with [Camoufox](https://github.com/daijro/camoufox) anti-detection capabilities. ## Features - **21 browser automation tools** for complete browser control - **Anti-detection**: Automatic fingerprint randomization to avoid bot detection - **Lazy initialization**: Browser only launches on first tool call - **Persistent sessions**: Browser persists between tool calls - **Tab management**: Support for multiple tabs/pages - **Form automation**: Fill forms, upload files, handle dialogs ## Installation ### Quick Start (uvx - recommended) ```bash uvx camoufox-mcp ``` ### Using pipx ```bash pipx run camoufox-mcp ``` ### Using pip ```bash pip install camoufox-mcp camoufox-mcp ``` ### From source ```bash # Clone the repository git clone https://github.com/rlgrpe/camoufox-mcp-python.git cd camoufox-mcp-python # Install with uv uv sync ``` ### Install Camoufox browser After installing the package, you need to download the Camoufox browser binary: ```bash # macOS python3 -m camoufox fetch # Linux python -m camoufox fetch # Also install system dependencies: # Ubuntu/Debian: sudo apt install -y libgtk-3-0 libx11-xcb1 libasound2 # Arch: sudo pacman -S gtk3 libx11 libxcb cairo libasound alsa-lib # Windows camoufox fetch ``` To uninstall the browser binary: ```bash camoufox remove ``` ## Usage ### Start the server ```bash # Using uvx (recommended) uvx camoufox-mcp # Using uv (from source) uv run camoufox-mcp # Or as a module python -m camoufox_mcp ``` ### Add to Claude Code ```bash claude mcp add camoufox-mcp -- uvx camoufox-mcp ``` ### Claude Desktop Configuration Add to your Claude Desktop config file: ```json { "mcpServers": { "camoufox-mcp": { "command": "uvx", "args": ["camoufox-mcp"] } } } ``` Or if running from source: ```json { "mcpServers": { "camoufox-mcp": { "command": "uv", "args": [ "run", …