Camoufox MCP Server

An MCP (Model Context Protocol) server that provides browser automation capabilities using Camoufox, a privacy-focused Firefox fork with advanced anti-detection features.

Quick Install

Use the published npm package unless you are developing this repository locally.

Claude Code CLI

claude mcp add camoufox -- npx -y camoufox-mcp-server@latest

For a shared project-scoped Claude Code config:

claude mcp add --scope project camoufox -- npx -y camoufox-mcp-server@latest

Verify with /mcp inside Claude Code.

Codex CLI

codex mcp add camoufox -- npx -y camoufox-mcp-server@latest

Codex stores MCP servers in ~/.codex/config.toml by default. Verify with /mcp inside Codex.

opencode

Add this to opencode.json in your project or to ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "camoufox": {
      "type": "local",
      "command": ["npx", "-y", "camoufox-mcp-server@latest"],
      "enabled": true
    }
  }
}

Verify with:

opencode mcp list

Pi Coding Agent

Install the MCP adapter, then add Camoufox to .mcp.json or ~/.config/mcp/mcp.json:

pi install npm:pi-mcp-adapter

{
  "mcpServers": {
    "camoufox": {
      "command": "npx",
      "args": ["-y", "camoufox-mcp-server@latest"]
    }
  }
}

Try Camoufox

Once configured, ask your assistant for browser work in plain language:

Use Camoufox to browse https://example.com and return metadata only.

Use Camoufox to inspect the interactive elements on https://example.com.

Use Camoufox to open https://example.com, take a screenshot, and summarize the visible page.

Use Camoufox to browse https://developer.mozilla.org with images blocked and WebRTC blocked.

Features

• Advanced anti-detection: rotating OS fingerprints, realistic cursor movements, and browser fingerprint spoofing.

• Enhanced parameters: configurable wait strategies, timeouts, viewport dimensions, diagnostics, and screenshots.

• Cross-platform: works on Windows, macOS, and Linux, including Docker.

• Privacy controls: SSRF protections, WebRTC blocking, WebGL blocking, image blocking, proxy support, and bounded output.

• Session tools: short-lived isolated browser sessions with challenge pause/resume support.

Requirements

• Node.js 22 or higher

• Python 3.x for running tests

Documentation

• Configuration for AI assistants

• Usage examples

• Tool parameters

• Server policy

• Development

• Troubleshooting

• Privacy and security

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome. Please submit a pull request or open an issue for bugs and feature requests.

Acknowledgments

• Built with Camoufox

• Uses the Model Context Protocol

• Powered by Playwright

Support

If you encounter issues, check Troubleshooting first, then open an issue on GitHub with logs and environment details.