Camofox Browser MCP

camofox-browser-mcp

MCP server for controlling a local camofox-browser instance.

______________________________________________________________________

快速安装

将此内容粘贴到llm代理会话中：

Install and configure camofox-browser-mcp by following the instructions here:
https://raw.githubusercontent.com/Microck/camofox-browser-mcp/refs/heads/main/INSTALL.md

npm（推荐）

npm install -g camofox-browser-mcp

用于控制本地的MCP服务器 Jo-inc/camofox-浏览器 例子

此服务器向LLM代理公开了完整实用的camofox浏览器工作流程： 标签生命周期、导航、交互、快照、屏幕截图、链接、统计数据， cookie导入、会话清理、YouTube转录提取和高级 复合助手程序(navigate_and_snapshot, scroll_and_snapshot, fill_form, type_and_submit, batch_click, web_search).

先决条件

1. Node.js 22+（npm包需要）
2. 可选：Bun（建议用于当地开发）：
3. 跑步 camofox-browser 服务器（默认 http://127.0.0.1:9377)
4. 可选，取决于使用的工具：

- CAMOFOX_API_KEY 用于cookie导入 - CAMOFOX_ADMIN_KEY 用于浏览器停止端点

安装

当地开发检查

git clone https://github.com/Microck/camofox-browser-mcp.git
cd camofox-browser-mcp
bun install
bun run typecheck
bun run build

npm 包

npm install -g camofox-browser-mcp

# optional smoke-run (most users just configure their MCP client)
camofox-browser-mcp

配置

在MCP客户端配置中设置这些环境变量。

MCP配置示例（本地构建）

{
  "mcpServers": {
    "camofox-browser-mcp": {
      "command": "bun",
      "args": ["/absolute/path/to/camofox-browser-mcp/dist/index.js"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio",
        "MCP_LOG_LEVEL": "info",
        "CAMOFOX_BASE_URL": "http://127.0.0.1:9377",
        "CAMOFOX_DEFAULT_USER_ID": "default-user",
        "CAMOFOX_DEFAULT_SESSION_KEY": "default-session",
        "CAMOFOX_API_KEY": "",
        "CAMOFOX_ADMIN_KEY": ""
      }
    }
  }
}

工具覆盖范围

MCP工具集映射到 camofox-browser 端点，包括兼容性 常用别名 camofox-mcp 提示。

服务器和会话工具

选项卡生命周期工具

导航和交互工具

内容提取工具

支持的web_search引擎

web_search 地图 engine 后端宏的值：

• google, youtube, amazon, reddit, wikipedia, twitter, yelp
• spotify, netflix, linkedin, instagram, tiktok, twitch

兼容性说明

• list_profiles, save_profile, load_profile，以及 delete_profile 不是

尚未暴露，因为电流 jo-inc/camofox-browser API不提供 cookie导出/配置文件端点。

典型工作流程

1. camofox_start_browser
2. camofox_create_tab （或 camofox_list_tabs +再利用）
3. camofox_navigate_tab
4. camofox_get_snapshot
5. 与裁判互动： camofox_click, camofox_type, camofox_press, camofox_scroll
6. 重新运行 camofox_get_snapshot 主要页面更改后
7. 清理 camofox_close_tab 或 camofox_close_session

宏观支持

camofox_navigate_tab 通过 macro 和 query 通过camofox浏览器。 上游宏包括：

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

故障排除

• camofox_health 失败：检查 CAMOFOX_BASE_URL 并确认后端正在运行。
• camofox_import_cookies 403：设置 CAMOFOX_API_KEY 在后端和MCP环境中。
• camofox_stop_browser 403：设置 CAMOFOX_ADMIN_KEY 在后端和MCP环境中。
• 导航后缺少参考文献：调用 camofox_get_snapshot 再一次。

许可证

麻省理工学院