Camoufox MCP Python

迷彩MCP服务器

已弃用：移至 camoufox-browser

此存储库已弃用。 该项目已转移到：

• 存储库：https://github.com/rlgrpe/camoufox-browser-cli
• PyPI：https://pypi.org/project/camoufox-browser/

Python MCP（模型上下文协议）服务器提供完全的浏览器自动化 迷彩 反检测能力。

特性

• 21种浏览器自动化工具 用于完全控制浏览器
• 反侦测：自动指纹随机化，避免机器人检测
• 惰性初始化：浏览器仅在第一次工具调用时启动
• 持续会话：浏览器在工具调用之间保持不变
• 选项卡管理：支持多个选项卡/页面
• 表单自动化：填写表单、上传文件、处理对话框

安装

快速入门（uvx-推荐）

uvx camoufox-mcp

使用pipx

pipx run camoufox-mcp

使用pip

pip install camoufox-mcp
camoufox-mcp

来源

# Clone the repository
git clone https://github.com/rlgrpe/camoufox-mcp-python.git
cd camoufox-mcp-python

# Install with uv
uv sync

安装camofox浏览器

安装软件包后，您需要下载迷彩浏览器二进制文件。 该命令取决于您安装软件包的方式：

如果通过uvx安装（推荐）

uvx camoufox fetch

如果通过pipx安装

pipx run camoufox fetch

如果通过pip安装

# macOS
python3 -m camoufox fetch

# Linux
python -m camoufox fetch

# Windows
camoufox fetch

如果从源头安装（紫外线）

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

卸载浏览器二进制文件

# Use the same method as installation:
uvx camoufox remove          # if using uvx
pipx run camoufox remove     # if using pipx
camoufox remove              # if using pip
uv run python -m camoufox remove  # if using uv from source

用法

启动服务器

# Using uvx (recommended)
uvx camoufox-mcp

# Using uv (from source)
uv run camoufox-mcp

# Or as a module
python -m camoufox_mcp

添加到克劳德代码

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

Claude桌面配置

添加到您的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个工具）

配置

浏览器可以通过以下方式配置 BrowserConfig 上课中 camoufox_mcp/config.py。可用选项：

代理配置示例

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

发展

# Install dev dependencies
uv sync --dev

# Run tests
uv run pytest

# Format code
uv run ruff format

# Lint
uv run ruff check

许可证

MIT许可证-请参阅 许可证 了解详情。

相关项目

• 迷彩 -此MCP服务器所基于的反检测浏览器
• 主控程序 -模型上下文协议规范
• FastMCP -用于构建MCP服务器的Python框架