camoufox -python

The Camoufox MCP server provides a Python-based Model Context Protocol (MCP) interface to automate a Camoufox-powered browser with anti-detection features. It ships with a suite of 21 tools organized into Navigation, Interaction, Page, Forms, and Session categories, enabling complete browser control, form automation, and tab management while preserving sessions across calls. Typical usage includes starting the MCP server, then issuing tool invocations such as browser_navigate, browser_click, browser_type, browser_take_screenshot, and browser_tabs to manage tabs and sessions. The server lazily initializes the browser on the first tool call and maintains the browser state between tool invocations, helping you script complex interactions across multiple steps without re-launching the browser each time. When integrated with Claude or other orchestration layers, you can add the MCP server as a resource and call its tools to perform web automation tasks while benefiting from anti-detection capabilities during automated browsing.

Prerequisites:

• Python 3.8+ installed
• Your preferred method to run Python packages (uv, pipx, or pip)
• Git (if you plan to install from source)

Installation (recommended quick start using uvx):

1. Install and run the MCP server via uvx:

uvx camoufox-mcp

2. Alternatively, install with uv (from source or local development):

uv run camoufox-mcp

3) Install via pipx (recommended for isolated environments):

```bash
pipx run camoufox-mcp

4) Install via pip (if you prefer direct Python package installation):

```bash
pip install camoufox-mcp
camoufox-mcp

5) If building 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

6. Install Camoufox browser binary after package installation:

• If using uvx (recommended):

uvx camoufox fetch

• If using pipx:

pipx run camoufox fetch

• If using pip:

# macOS
python3 -m camoufox fetch

# Linux
python -m camoufox fetch

# Windows
camoufox fetch

7. On Linux, install additional system dependencies as needed:

# Ubuntu/Debian
sudo apt install -y libgtk-3-0 libx11-xcb1 libasound2

# Arch
sudo pacman -S gtk3 libx11 libxcb cairo libasound alsa-lib

8. To uninstall the browser binary, use the same method as installation:

# uvx
uvx camoufox remove

# pipx
pipx run camoufox remove

# pip
camoufox remove

# from source (uv)
uv run python -m camoufox remove

Tips and considerations:

• The browser initializes lazily on the first tool call, which can help speed up startup in scripted scenarios.
• Persistent sessions allow multi-step automation without re-creating the browser context between calls.
• If you encounter environment-specific issues, ensure the Camoufox binary has proper permissions and the system dependencies for your OS are installed.
• The Tools Reference in the README enumerates 21 tools across Navigation, Interaction, Page, Forms, and Session categories; use them to build end-to-end automation flows.
• When integrating with Claude or other tooling, you can add the server under mcpServers with the uvx camoufox-mcp command, or adjust to the appropriate runtime if running from source.
• If you need to customize browser behavior, consult the BrowserConfig options in camoufox_mcp/config.py, including headless mode, geolocation, proxy, and fingerprint randomization controls.