浏览器自动化服务

CamoFox MCP服务器是一个为AI代理提供的浏览器自动化工具,通过REST API实现反检测浏览和页面操作功能。

  • by thebtf
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 thebtf/camofox-mcp

使用说明

卡莫福克斯mcp

MCP服务器 卡莫福克斯 --AI代理的反检测浏览器自动化。

没有启动本地浏览器。 这是运行在其他地方(Docker、远程服务器等)的CamoFox REST API上的一个精简MCP包装器。

为什么

CamoFox通过以下方式提供反检测浏览 迷彩 (带有C++指纹欺骗的Firefox分叉)。此MCP服务器允许任何与MCP兼容的AI代理(OpenClaw、Claude Desktop等)将其用作工具。

快速开始

1.在某处启动CamoFox服务器

# Docker (recommended)
docker run -p 9377:9377 jo-inc/camofox-browser

# Or standalone
git clone https://github.com/jo-inc/camofox-browser
cd camofox-browser && npm install && npm start

2.运行MCP服务器

# With uvx (no install needed)
CAMOFOX_URL=http://your-server:9377 uvx camofox-mcp

# Or install and run
pip install camofox-mcp
CAMOFOX_URL=http://your-server:9377 camofox-mcp

3.配置您的MCP客户端

OpenClaw(麦克波特)

mcporter config add camofox --stdio \
  "CAMOFOX_URL=http://your-server:9377 CAMOFOX_USER=agent uvx camofox-mcp"

克劳德桌面/光标

{
  "mcpServers": {
    "camofox": {
      "command": "uvx",
      "args": ["camofox-mcp"],
      "env": {
        "CAMOFOX_URL": "http://your-server:9377",
        "CAMOFOX_USER": "agent"
      }
    }
  }
}

环境变量

变量 默认值 描述
CAMOFOX_URL http://localhost:9377 camofox服务器URL
CAMOFOX_USER default 会话隔离的用户ID
CAMOFOX_TIMEOUT 30 HTTP请求超时(秒)

工具

工具 说明
camofox_health 检查服务器状态
camofox_navigate 打开URL→ 获取可访问性快照
camofox_snapshot 获取当前页面快照
camofox_click 按ref(e1,e2…)单击元素
camofox_type 在元素中键入文本
camofox_press 按键盘键
camofox_scroll 滚动页面(上/下/左/右)
camofox_navigate_tab 将现有选项卡导航到新URL
camofox_search 使用搜索宏(@google_search等)
camofox_links 从页面中提取所有链接
camofox_screenshot 截图(返回文件路径)
camofox_tabs 列出打开的选项卡
camofox_close 关闭选项卡
camofox_close_all 关闭所有选项卡
camofox_back 浏览器历史记录返回
camofox_forward 浏览器历史记录转发

搜索宏

@google_search · @youtube_search · @amazon_search · @reddit_search · @wikipedia_search · @twitter_search · @yelp_search · @spotify_search · @netflix_search · @linkedin_search · @instagram_search · @tiktok_search · @twitch_search

建筑

AI Agent ←(MCP/stdio)→ camofox-mcp ←(REST/HTTP)→ CamoFox Server ←→ Camoufox Browser

MCP服务器是无状态的——所有状态都存在于CamoFox服务器中。多个MCP客户端可以连接到具有不同配置的同一CamoFox实例 CAMOFOX_USER 会话隔离值。

安全

  • 所有用户输入(URL、文本、引用)都是JSON编码的,没有shell插值
  • 选项卡ID在路径中使用之前已进行URL编码
  • 不会存储或传输超出CamoFox要求的凭据
  • MCP服务器从不启动浏览器,它只代理现有的CamoFox实例

许可证

麻省理工学院