Camoufox MCP Python

🚀 Camoufox MCP 服務器

Camoufox MCP 服務器是一個用 Python 編寫的 MCP（模型上下文協議）服務器，藉助 Camoufox 的反檢測功能，提供完整的瀏覽器自動化操作。

🚀 快速開始

啟動服務器

# 使用 uvx（推薦）
uvx camoufox-mcp

# 使用 uv（從源碼啟動）
uv run camoufox-mcp

# 或者作為模塊啟動
python -m camoufox_mcp

添加到 Claude Code

claude mcp add camoufox-mcp -- uvx camoufox-mcp

Claude 桌面端配置

將以下內容添加到你的 Claude 桌面端配置文件中：

{
  "mcpServers": {
    "camoufox-mcp": {
      "command": "uvx",
      "args": ["camoufox-mcp"]
    }
  }
}

或者如果你是從源碼運行：

{
  "mcpServers": {
    "camoufox-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/camoufox-mcp-python",
        "camoufox-mcp"
      ]
    }
  }
}

✨ 主要特性

• 21 種瀏覽器自動化工具：可完全控制瀏覽器。
• 反檢測功能：自動隨機化指紋，避免被檢測為機器人。
• 懶初始化：僅在首次調用工具時啟動瀏覽器。
• 持久會話：瀏覽器在工具調用之間保持運行。
• 標籤管理：支持多個標籤頁。
• 表單自動化：填充表單、上傳文件、處理對話框。

📦 安裝指南

快速開始（uvx - 推薦）

uvx camoufox-mcp

使用 pipx

pipx run camoufox-mcp

使用 pip

pip install camoufox-mcp
camoufox-mcp

從源碼安裝

# 克隆倉庫
git clone https://github.com/rlgrpe/camoufox-mcp-python.git
cd camoufox-mcp-python

# 使用 uv 安裝
uv sync

安裝 Camoufox 瀏覽器

安裝包後，你需要下載 Camoufox 瀏覽器二進制文件。命令取決於你安裝包的方式：

如果通過 uvx 安裝（推薦）

uvx camoufox fetch

如果通過 pipx 安裝

pipx run camoufox fetch

如果通過 pip 安裝

# macOS
python3 -m camoufox fetch

# Linux
python -m camoufox fetch

# Windows
camoufox fetch

如果從源碼安裝（uv）

uv run python -m camoufox fetch

Linux 系統依賴

在 Linux 上，你還需要安裝系統依賴：

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

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

卸載瀏覽器二進制文件

# 使用與安裝相同的方法：
uvx camoufox remove          # 如果使用 uvx
pipx run camoufox remove     # 如果使用 pipx
camoufox remove              # 如果使用 pip
uv run python -m camoufox remove  # 如果從源碼使用 uv

💻 使用示例

基礎用法

你可以按照上述快速開始部分的命令啟動服務器，並根據需求調用不同的工具。例如，使用 browser_navigate 工具導航到指定 URL：

# 假設已經啟動服務器，調用 browser_navigate 工具
# 這裡需要根據實際的 MCP 調用方式來編寫，示例代碼僅為示意
# 實際調用可能會涉及到 MCP 協議的具體實現

📚 詳細文檔

工具參考

導航（4 個工具）

交互（6 個工具）

頁面（4 個工具）

表單（3 個工具）

會話（4 個工具）

配置

可以通過 camoufox_mcp/config.py 中的 BrowserConfig 類來配置瀏覽器。可用選項如下：

代理配置示例

proxy = {
    'server': 'http://proxy.example.com:8080',
    'username': 'user',
    'password': 'pass'
}

🔧 技術細節

開發

# 安裝開發依賴
uv sync --dev

# 運行測試
uv run pytest

# 格式化代碼
uv run ruff format

# 代碼檢查
uv run ruff check

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE。

相關項目

• Camoufox - 此 MCP 服務器所基於的反檢測瀏覽器。
• MCP - 模型上下文協議規範。
• FastMCP - 用於構建 MCP 服務器的 Python 框架。