webfetch-camouflage-mcp

Webfetch Camouflage is an MCP server for fetching web content with browser camouflage using curl_cffi. It mimics real browser TLS/HTTP2 fingerprints to bypass bot detection, returning clean Markdown output converted from HTML.

Installation

<details> <summary>Cursor</summary>

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "webfetch-camouflage": {
      "command": "uvx",
      "args": ["git+https://github.com/tianhuil/webfetch-camouflage-mcp.git"]
    }
  }
}

</details>

<details> <summary>Claude Code</summary>

claude mcp add-json webfetch-camouflage '{"command":"uvx","args":["git+https://github.com/tianhuil/webfetch-camouflage-mcp.git"]}'

</details>

<details> <summary>VSCode</summary>

code --add-mcp '{"name":"webfetch-camouflage","command":"uvx","args":["git+https://github.com/tianhuil/webfetch-camouflage-mcp.git"]}'

</details>

<details> <summary>Gemini CLI</summary>

gemini mcp add webfetch-camouflage uvx -- git+https://github.com/tianhuil/webfetch-camouflage-mcp.git

</details>

<details> <summary>Codex CLI</summary>

codex mcp add webfetch-camouflage -- uvx git+https://github.com/tianhuil/webfetch-camouflage-mcp.git

</details>

<details> <summary>Opencode</summary>

Add to opencode.json:

macOS/Linux: ~/.local/share/opencode/opencode.json Windows: %LOCALAPPDATA%\opencode\opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "webfetch-camouflage": {
      "type": "local",
      "command": ["uvx", "git+https://github.com/tianhuil/webfetch-camouflage-mcp.git"],
      "enabled": true
    }
  }
}

</details>

Tool reference

The fetch_url tool accepts:

• url (required): URL to fetch
• impersonate (optional, default "chrome"): browser profile to impersonate
• timeout (optional, default 10): request timeout in seconds
• max_chars (optional): maximum characters to return; truncates with ... if set

Supported impersonation profiles:

• Chrome: chrome99, chrome100, chrome101, chrome104, chrome107, chrome110, chrome116, chrome119, chrome120, chrome123, chrome124, chrome131, chrome133a, chrome136
• Firefox: firefox133, firefox135
• Safari: safari153, safari155, safari170, safari180, safari184, safari260
• Edge: edge99, edge101, edge133, edge135

Notes on Development

Setup

git clone https://github.com/tianhuil/webfetch-camouflage-mcp.git
cd webfetch-camouflage-mcp
uv sync

Running the server

uv run webfetch-camouflage-mcp

Available tasks

poe test       # Run tests
poe lint       # Lint code
poe format     # Format code
poe typecheck  # Type check
uv run pip-audit  # Security audit

MCP server testing

Test the server directly via JSON-RPC:

echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0"}}}' | uv run webfetch-camouflage-mcp

echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0"}}}' | uvx git+https://github.com/tianhuil/webfetch-camouflage-mcp.git

Or use the helper script:

uv run python src/get_tool_details.py