How does Camoufox achieve anti-detection capabilities?

Camoufox employs automatic fingerprint randomization, spoofs OS, blocks WebRTC/WebGL leaks, supports proxy configurations, and offers human-like cursor movements to mimic real user behavior and bypass bot detection effectively.

Does Camoufox support persistent browser sessions and tab management?

Yes, Camoufox is designed for persistent browser sessions, meaning the browser state is maintained across multiple tool calls. It also fully supports creating, managing, and switching between multiple tabs and pages within a single session.

What kind of automation tasks can Camoufox handle?

Camoufox provides 21 specialized tools for comprehensive browser control. It can handle navigation, element interaction (click, type, hover), form automation (fill forms, file uploads, dialogs), page evaluation, screenshot capture, and more.

What is Camoufox and its primary use?

Camoufox is an MCP (Model Context Protocol) server that provides full browser automation, leveraging the Camoufox anti-detection browser. Its primary use is to perform web automation and scraping tasks robustly while avoiding bot detection.

How can I integrate Camoufox into my projects?

Camoufox can be installed via uvx, pipx, or pip. As an MCP server, it's designed for seamless integration with MCP-compatible platforms like Claude Code and Claude Desktop, offering flexible configuration options for advanced use cases.

Camoufox is a Python-based Model Context Protocol (MCP) server designed to offer comprehensive browser automation with advanced anti-detection capabilities. It leverages the Camoufox anti-detect browser to automatically randomize browser fingerprints, helping to bypass bot detection mechanisms. The server provides a rich set of 21 browser automation tools, allowing for complete control over web interactions, including navigation, element interaction, form handling, and tab management. It supports lazy initialization and persistent sessions, making it efficient for continuous automation tasks and ideal for integration with AI agents like Claude for sophisticated web-based operations and web scraping that requires stealth.

主な機能

01Comprehensive form automation including file uploads and dialog handling

02Anti-detection with automatic fingerprint randomization

031 GitHub stars

04Support for multiple tabs and pages

0521 browser automation tools for complete control

06Persistent browser sessions between tool calls

ユースケース

01Automating web tasks and workflows while evading bot detection

02Integrating advanced browser control into AI agents and language models via MCP

03Performing web scraping and data collection with enhanced stealth

Camoufox MCP Server

A Python MCP (Model Context Protocol) server providing full browser automation with 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)

uvx camoufox-mcp

Using pipx

pipx run camoufox-mcp

Using pip

pip install camoufox-mcp
camoufox-mcp

From source

# 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:

# 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:

camoufox remove

Usage

Start the server

# 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

claude mcp add camoufox-mcp -- uvx camoufox-mcp

Claude Desktop Configuration

Add to your Claude Desktop config file:

{
  "mcpServers": {
    "camoufox-mcp": {
      "command": "uvx",
      "args": ["camoufox-mcp"]
    }
  }
}

Or if running from source:

{
  "mcpServers": {
    "camoufox-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/camoufox-mcp-python",
        "camoufox-mcp"
      ]
    }
  }
}

Tools Reference

Navigation (4 tools)

Tool	Description
`browser_navigate`	Navigate to a URL
`browser_navigate_back`	Go back to the previous page
`browser_snapshot`	Capture accessibility snapshot of the current page
`browser_wait_for`	Wait for text to appear/disappear or a specified time

Interaction (6 tools)

Tool	Description
`browser_click`	Click on an element
`browser_type`	Type text into an element
`browser_hover`	Hover over an element
`browser_drag`	Drag and drop between two elements
`browser_press_key`	Press a key on the keyboard
`browser_select_option`	Select an option in a dropdown

Page (4 tools)

Tool	Description
`browser_evaluate`	Evaluate JavaScript on the page or element
`browser_console_messages`	Get console messages
`browser_network_requests`	Get network requests
`browser_take_screenshot`	Take a screenshot

Forms (3 tools)

Tool	Description
`browser_fill_form`	Fill multiple form fields
`browser_file_upload`	Upload files
`browser_handle_dialog`	Handle dialogs (alert, confirm, prompt)

Session (4 tools)

Tool	Description
`browser_tabs`	List, create, close, or select tabs
`browser_resize`	Resize the browser window
`browser_close`	Close the browser
`browser_install`	Install Camoufox browser

Configuration

The browser can be configured via the BrowserConfig class in camoufox_mcp/config.py. Available options:

Parameter	Type	Default	Description
`os`	str	None	OS to spoof (windows/macos/linux)
`headless`	bool/str	False	Headless mode (or 'virtual')
`humanize`	bool/float	True	Human-like cursor movements
`geoip`	bool	True	Auto-detect geolocation from IP
`proxy`	str/dict	None	Proxy configuration
`block_webrtc`	bool	True	Block WebRTC leaks
`block_webgl`	bool	False	Block WebGL fingerprinting
`block_images`	bool	False	Block image loading
`locale`	str	None	Browser locale
`viewport`	dict	None	Viewport dimensions
`enable_cache`	bool	True	Enable caching
`timeout`	int	30000	Page load timeout (ms)
`wait_strategy`	str	"domcontentloaded"	Wait strategy
`ublock`	bool	False	Enable uBlock Origin

Proxy Configuration Example

proxy = {
    'server': 'http://proxy.example.com:8080',
    'username': 'user',
    'password': 'pass'
}

Development

# Install dev dependencies
uv sync --dev

# Run tests
uv run pytest

# Format code
uv run ruff format

# Lint
uv run ruff check

License

MIT License - see LICENSE for details.

Related Projects

Camoufox - The anti-detect browser this MCP server is built on
MCP - Model Context Protocol specification
FastMCP - Python framework for building MCP servers

Camoufox