1. Conduid
  2. Developer Tools
  3. Camoufox MCP Python
MCP server · Developer Tools

Camoufox MCP Python

by · github.com/rlgrpe/camoufox-mcp-python

MCP server for browser automation with Camoufox anti-detection capabilities

Unclaimed MIT last commit 6 months ago camoufoxcamoufox-mcpmcp
InstallView source
58Fair

Scored 21 days ago · breakdown

About Camoufox MCP Python

Camoufox MCP Python is an MCP server published by rlgrpe in the Developer Tools category: mCP server for browser automation with Camoufox anti-detection capabilities.

The repository has 10 stars and 1 forks, with the last commit 6 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/rlgrpe/camoufox-mcp-python

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (4)

browser_navigateNavigate to a URL

Parameters not published.

browser_navigate_backGo back to the previous page

Parameters not published.

browser_snapshotCapture accessibility snapshot of the current page

Parameters not published.

browser_wait_forWait for text to appear/disappear or a specified time

Parameters not published.

Ask AI

✦

Ask AI about Camoufox MCP Python

Powered by Claude · Grounded in docs

I know everything about Camoufox MCP Python. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 2 hours ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

README

Camoufox MCP Server

Deprecated: moved to camoufox-browser

This repository is deprecated. The project has moved to:

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. The command depends on how you installed the package:

If installed via uvx (recommended)

uvx camoufox fetch

If installed via pipx

pipx run camoufox fetch

If installed via pip

# macOS
python3 -m camoufox fetch

# Linux
python -m camoufox fetch

# Windows
camoufox fetch

If installed from source (uv)

uv run python -m camoufox fetch

Linux system dependencies

On Linux, you also need to 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

To uninstall the browser binary

# Use the same method as installation:
uvx camoufox remove          # if using uvx
pipx run camoufox remove     # if using pipx
camoufox remove              # if using pip
uv run python -m camoufox remove  # if using uv from source

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

README fetched from the repository 2 hours ago. The original is authoritative.

Questions

About Camoufox MCP Python

How do I install Camoufox MCP Python?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Camoufox MCP Python safe to use with an AI agent?

Its trust score is 58 out of 100 (fair). It passes 4 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Camoufox MCP Python still maintained?

The last commit was 6 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.