Camoufox MCP Python

🚀 Camoufox MCP Server

Camoufox MCP Serverは、Camoufoxの検知回避機能を備えた、完全なブラウザ自動化を提供するPython MCP（Model Context Protocol）サーバーです。

✨ 主な機能

• 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を使用した場合

💻 使用例

サーバーを起動する

# uvxを使用する場合 (推奨)
uvx camoufox-mcp

# ソースからuvを使用する場合
uv run camoufox-mcp

# モジュールとして実行する場合
python -m camoufox_mcp

Claude Codeに追加する

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

Claude Desktopの設定

Claude Desktopの設定ファイルに追加します。

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

または、ソースから実行する場合：

{
  "mcpServers": {
    "camoufox-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/camoufox-mcp-python",
        "camoufox-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フレームワーク