home / mcp / camoufox mcp server
Provides anti-detection, browser automation via Camoufox with configurable proxies and event-driven actions.
Configuration
View docs{
"mcpServers": {
"baixianger-camoufox-mcp": {
"command": "npx",
"args": [
"camoufox-mcp"
],
"env": {
"PROXY_PASS": "password",
"PROXY_USER": "username",
"PROXY_SERVER": "http://1.2.3.4:8080"
}
}
}
}Camoufox MCP provides a dedicated server wrapper for automating browser tasks with the anti-detection Camoufox Firefox-based browser. It enables you to run browser automation in a controlled MCP environment, with built-in anti-detection features and configurable proxy support to help you operate in varied network conditions.
You use an MCP client to connect to the Camoufox MCP server. Start the server wrapper locally, then point your MCP client to the Camoufox endpoint or launch it as a local process through your MCP client workflow. The server exposes automation capabilities powered by Camoufox, including realistic cursor movements, human-like interaction delays, and proxy-enabled operation. You can run tasks that interact with web pages, manage cookies, intercept network activity, and capture console output while leveraging anti-detection features.
Prerequisites you need before installing:
• Node.js (16.x or later) and npm or npx installed on your machine.
Step-by-step install and run flow:
1. Install Camoufox MCP by running the MCP launcher command:
npx camoufox-mcpIf you want to route traffic through a proxy, configure the MCP server with proxy details and, optionally, environment variables for proxy authentication. You can provide proxy settings via the MCP server configuration and the client’s environment, enabling GeoIP-based adjustments and authenticated proxies.
Example configurations you can apply in your environment to enable proxy support and startup parameters are shown below.
{
"mcpServers": {
"camoufox": {
"command": "npx",
"args": ["camoufox-mcp"]
}
}
}{
"mcpServers": {
"camoufox": {
"command": "npx",
"args": ["camoufox-mcp"],
"env": {
"PROXY_SERVER": "http://1.2.3.4:8080",
"PROXY_USER": "username",
"PROXY_PASS": "password"
}
}
}
}// Client-side settings example (proxy configuration)
{
"proxy": {
"enabled": true,
"server": "${PROXY_SERVER}",
"username": "${PROXY_USER}",
"password": "${PROXY_PASS}",
"geoip": true
}
}You can keep the browser visible for debugging by setting the browser to headful mode and adjusting the viewport and timeouts in the settings. Proxy settings may enable GeoIP-based timezone and locale adjustments to better match the proxy location.
Use authenticated proxies only when required and ensure your environment securely stores credentials. Regularly review network interception and console capture settings to balance visibility with privacy and compliance.
If the server fails to start, verify Node.js installation, ensure the MCP launcher command is accessible, and confirm proxy environment variables are correctly set. Check that the configured proxy server is reachable and that authentication credentials are valid.
Built-in capabilities to bypass common bot detection techniques to allow automated interactions to proceed without triggering deterrents.
Randomizes browser fingerprint characteristics to reduce traceability across runs.
Prevents WebRTC-related IP leakage that could reveal automated activity.
Spoofs canvas fingerprint to reduce unique fingerprint visibility.
Generates realistic cursor paths rather than instantaneous movements.
Introduces delays between click events to mimic human behavior.
Automatically configures proxy-based geography and timezone settings to align with the proxy location.
Supports evaluating code in the main document context, including special data structures like __NUXT__ and __NEXT_DATA__.
Allows isolated code evaluation in an asynchronous context to keep executions separate.
Automatically dismisses common cookie consent popups using multiple selectors.
Captures user-like actions for reproducibility and scripting.
Intercepts network requests for monitoring and manipulation.
Captures console output for debugging and analysis.