camofox-browser MCP服务器接入Claude Code/Cursor/Codex配置全解【免费下载链接】camofox-browserStealth headless browser for AI agents — bypass Cloudflare, bot detection, and anti-scraping. Drop-in Puppeteer/Playwright replacement.项目地址: https://gitcode.com/GitHub_Trending/ca/camofox-browsercamofox-browser是一款面向 AI 智能体的隐身无头浏览器服务器底层由 Camoufox在 C 层做指纹伪装的 Firefox 分支驱动可绕过 Cloudflare、机器人检测与反爬机制是 Puppeteer/Playwright 的直接替代品。它内置了一个独立可安装的MCP 服务器camofox-browser-mcp只需一次配置就能让Claude Code、Cursor、Codex CLI等主流 AI 编程工具直接获得 11 个浏览器操作工具无需 OpenClaw 也能用。一、为什么你的 AI 编程助手需要一个隐身浏览器AI 智能体要干活就得浏览真实的网页查资料、看报错页面、抓取数据。但默认方案很容易碰壁Playwright 控制的浏览器经常被拦无头 Chrome 会被指纹识别各种隐身插件反而成了新的指纹特征。camofox-browser 的思路不同Camoufox 直接在C 实现层修改 Firefoxnavigator.hardwareConcurrency、WebGL 渲染器、AudioContext、屏幕几何、WebRTC 全部在 JavaScript 看到之前就被伪装无需任何 shim 和包装层。在此之上项目把这套引擎封装成一个 REST 服务默认端口9377并提供基于MCPModel Context Protocol的 stdio 适配器让任意支持 MCP 的宿主直接调用浏览器能力。二、一步启动 REST 服务器MCP 的地基MCP 服务器只是翻译官真正跑浏览器的是 REST 服务器。两步启动git clone https://gitcode.com/GitHub_Trending/ca/camofox-browser cd camofox-browser npm install npm start # 首次运行会自动下载 Camoufox 浏览器约 300MB # - http://localhost:9377服务器在后台常驻即可无需保持当前目录。Docker 部署可参考仓库自带的 Makefilemake up一条命令搞定自动识别 CPU 架构。三、安装 camofox-browser-mcp 适配器4 选 1MCP 二进制对每个宿主都一样区别只在于粘到哪份配置文件里。先让camofox-browser-mcp命令出现在 PATH 中方式适用场景命令A. npm link已有源码仓库cd camofox-browser npm linkB. 全局安装最省事npm install -g askjo/camofox-browserC. npx不想安装任何东西npx -y askjo/camofox-browser-mcpD. 纯适配器REST 服务器跑在远端只要 stdio 桥进入 mcp/ 目录后npm install npm link推荐方式 D 的场景mcp/是一个独立 npm 包askjo/camofox-browser-mcp只依赖modelcontextprotocol/sdk不会拉取约 300MB 的浏览器二进制足迹最轻。工具名、JSON-Schema 参数与 REST 路由全部定义在 mcp/lib/tool-contracts.mjs 中与 OpenClaw 插件共用同一份契约两条路径的行为不可能漂移。验证命令是否全局可用which camofox-browser-mcp # 应输出 .../bin/camofox-browser-mcp四、Claude Code一条命令接入用户级所有项目可用claude mcp add camofox-browser -s user -- camofox-browser-mcp或者写入~/.claude.json用户级/.mcp.json项目级可提交进仓库{ mcpServers: { camofox-browser: { command: camofox-browser-mcp } } }进入 Claude Code 后输入/mcp看到camofox-browser显示 connected 即接入成功。五、Cursor配置文件或图形界面两种方式配置文件方式创建全局~/.cursor/mcp.json或项目级.cursor/mcp.json{ mcpServers: { camofox-browser: { command: camofox-browser-mcp } } }图形界面方式Settings → Cursor Settings → MCP → Add New MCP Server填入命令camofox-browser-mcp。完成后在 Settings → MCP 中看到服务器显示为绿色即表示就绪。六、Codex CLITOML 配置三行搞定编辑~/.codex/config.toml用户级或项目内.codex/config.toml仅限受信任目录[mcp_servers.camofox-browser] command camofox-browser-mcp env { CAMOFOX_BASE_URL http://localhost:9377 }顺带一提opencode 和 Antigravityagy的配置格式与 Cursor 基本一致改一下文件名即可opencode.json用mcp键 type: localagy 用~/.gemini/config/mcp_config.json。七、环境变量速查表大多数场景零配置即可运行以下变量按需添加变量默认值用途CAMOFOX_BASE_URLhttp://localhost:9377指向非本地的 REST 服务器CAMOFOX_USER_ID随机mcp-xxx会话隔离一个 MCP 实例 一个独立 camofox 会话CAMOFOX_SESSION_KEYdefault同一用户内的标签页分区CAMOFOX_ACCESS_KEY未设置REST 服务器开启了全局鉴权时必须与服务器侧一致MCP 会自动以Authorization: Bearer转发CAMOFOX_API_KEY未设置仅用于camofox_import_cookiesCookie 导入的密钥以 Claude Code 为例带环境变量的注册命令claude mcp add camofox-browser -s user \ --env CAMOFOX_BASE_URLhttp://localhost:9377 \ --env CAMOFOX_API_KEY你的密钥 \ -- camofox-browser-mcp八、接入后的 11 个工具有什么体验配置完成后你的 AI 编程助手将自动获得这套工具完整契约见 mcp/server.mjs工具用途camofox_create_tab打开 URL返回tabIdcamofox_snapshot无障碍快照 元素引用e1、e2… 截图camofox_navigate跳转 URL或调用搜索宏google_search、reddit_search…camofox_click/camofox_type按元素引用或 CSS 选择器点击/输入camofox_scroll/camofox_screenshot滚动与独立截图camofox_evaluate在页面上下文执行 JS提取数据camofox_list_tabs/camofox_close_tab标签页管理camofox_import_cookies导入 Netscape 格式 Cookie跳过交互式登录最佳实践所有交互遵循先快照、再操作的节奏——create_tab→snapshot拿到元素引用 → 用e1/e2这类稳定引用去click/type→ 再次snapshot确认状态 → 用完close_tab。相比 CSS 选择器元素引用无歧义选择器匹配到多个元素会返回422 strict mode violation此时重新快照改用引用即可。九、常见问题排查清单症状原因与解法503 session_expired/ tab create timed outREST 服务器会话已失效重启npm start422 strict mode violation … resolved to N elementsCSS 选择器匹配多个元素重新 snapshot 后改用元素引用点击403仅 Cookie 导入REST 与 MCP 两侧的CAMOFOX_API_KEY不一致401/403所有工具REST 服务器设置了CAMOFOX_ACCESS_KEYMCP 侧必须配置同一个值camofox_scroll返回 ok 但页面没动懒加载/虚拟滚动页面的已知行为改用camofox_evaluate执行window.scrollTo 更深入的 API 细节可查阅仓库内的 docs/api.html 与自动生成的 openapi.json完整接入说明在 mcp/README.md。写在最后从 clone 到接入 Claude Code / Cursor / Codex整个流程就是起一个 REST 服务 注册一个 MCP 命令两件事全程不到五分钟。配置完成后你的 AI 编程助手就拥有了一个能绕过反爬、Token 消耗比原始 HTML 小约 90% 的隐身浏览器——去让它帮你查页面、抓数据、跑端到端验证吧。【免费下载链接】camofox-browserStealth headless browser for AI agents — bypass Cloudflare, bot detection, and anti-scraping. Drop-in Puppeteer/Playwright replacement.项目地址: https://gitcode.com/GitHub_Trending/ca/camofox-browser创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 camofox-browser MCP服务器接入：Claude Code/Cursor/Codex配置全解
camofox-browser MCP服务器接入Claude Code/Cursor/Codex配置全解【免费下载链接】camofox-browserStealth headless browser for AI agents — bypass Cloudflare, bot detection, and anti-scraping. Drop-in Puppeteer/Playwright replacement.项目地址: https://gitcode.com/GitHub_Trending/ca/camofox-browsercamofox-browser是一款面向 AI 智能体的隐身无头浏览器服务器底层由 Camoufox在 C 层做指纹伪装的 Firefox 分支驱动可绕过 Cloudflare、机器人检测与反爬机制是 Puppeteer/Playwright 的直接替代品。它内置了一个独立可安装的MCP 服务器camofox-browser-mcp只需一次配置就能让Claude Code、Cursor、Codex CLI等主流 AI 编程工具直接获得 11 个浏览器操作工具无需 OpenClaw 也能用。一、为什么你的 AI 编程助手需要一个隐身浏览器AI 智能体要干活就得浏览真实的网页查资料、看报错页面、抓取数据。但默认方案很容易碰壁Playwright 控制的浏览器经常被拦无头 Chrome 会被指纹识别各种隐身插件反而成了新的指纹特征。camofox-browser 的思路不同Camoufox 直接在C 实现层修改 Firefoxnavigator.hardwareConcurrency、WebGL 渲染器、AudioContext、屏幕几何、WebRTC 全部在 JavaScript 看到之前就被伪装无需任何 shim 和包装层。在此之上项目把这套引擎封装成一个 REST 服务默认端口9377并提供基于MCPModel Context Protocol的 stdio 适配器让任意支持 MCP 的宿主直接调用浏览器能力。二、一步启动 REST 服务器MCP 的地基MCP 服务器只是翻译官真正跑浏览器的是 REST 服务器。两步启动git clone https://gitcode.com/GitHub_Trending/ca/camofox-browser cd camofox-browser npm install npm start # 首次运行会自动下载 Camoufox 浏览器约 300MB # - http://localhost:9377服务器在后台常驻即可无需保持当前目录。Docker 部署可参考仓库自带的 Makefilemake up一条命令搞定自动识别 CPU 架构。三、安装 camofox-browser-mcp 适配器4 选 1MCP 二进制对每个宿主都一样区别只在于粘到哪份配置文件里。先让camofox-browser-mcp命令出现在 PATH 中方式适用场景命令A. npm link已有源码仓库cd camofox-browser npm linkB. 全局安装最省事npm install -g askjo/camofox-browserC. npx不想安装任何东西npx -y askjo/camofox-browser-mcpD. 纯适配器REST 服务器跑在远端只要 stdio 桥进入 mcp/ 目录后npm install npm link推荐方式 D 的场景mcp/是一个独立 npm 包askjo/camofox-browser-mcp只依赖modelcontextprotocol/sdk不会拉取约 300MB 的浏览器二进制足迹最轻。工具名、JSON-Schema 参数与 REST 路由全部定义在 mcp/lib/tool-contracts.mjs 中与 OpenClaw 插件共用同一份契约两条路径的行为不可能漂移。验证命令是否全局可用which camofox-browser-mcp # 应输出 .../bin/camofox-browser-mcp四、Claude Code一条命令接入用户级所有项目可用claude mcp add camofox-browser -s user -- camofox-browser-mcp或者写入~/.claude.json用户级/.mcp.json项目级可提交进仓库{ mcpServers: { camofox-browser: { command: camofox-browser-mcp } } }进入 Claude Code 后输入/mcp看到camofox-browser显示 connected 即接入成功。五、Cursor配置文件或图形界面两种方式配置文件方式创建全局~/.cursor/mcp.json或项目级.cursor/mcp.json{ mcpServers: { camofox-browser: { command: camofox-browser-mcp } } }图形界面方式Settings → Cursor Settings → MCP → Add New MCP Server填入命令camofox-browser-mcp。完成后在 Settings → MCP 中看到服务器显示为绿色即表示就绪。六、Codex CLITOML 配置三行搞定编辑~/.codex/config.toml用户级或项目内.codex/config.toml仅限受信任目录[mcp_servers.camofox-browser] command camofox-browser-mcp env { CAMOFOX_BASE_URL http://localhost:9377 }顺带一提opencode 和 Antigravityagy的配置格式与 Cursor 基本一致改一下文件名即可opencode.json用mcp键 type: localagy 用~/.gemini/config/mcp_config.json。七、环境变量速查表大多数场景零配置即可运行以下变量按需添加变量默认值用途CAMOFOX_BASE_URLhttp://localhost:9377指向非本地的 REST 服务器CAMOFOX_USER_ID随机mcp-xxx会话隔离一个 MCP 实例 一个独立 camofox 会话CAMOFOX_SESSION_KEYdefault同一用户内的标签页分区CAMOFOX_ACCESS_KEY未设置REST 服务器开启了全局鉴权时必须与服务器侧一致MCP 会自动以Authorization: Bearer转发CAMOFOX_API_KEY未设置仅用于camofox_import_cookiesCookie 导入的密钥以 Claude Code 为例带环境变量的注册命令claude mcp add camofox-browser -s user \ --env CAMOFOX_BASE_URLhttp://localhost:9377 \ --env CAMOFOX_API_KEY你的密钥 \ -- camofox-browser-mcp八、接入后的 11 个工具有什么体验配置完成后你的 AI 编程助手将自动获得这套工具完整契约见 mcp/server.mjs工具用途camofox_create_tab打开 URL返回tabIdcamofox_snapshot无障碍快照 元素引用e1、e2… 截图camofox_navigate跳转 URL或调用搜索宏google_search、reddit_search…camofox_click/camofox_type按元素引用或 CSS 选择器点击/输入camofox_scroll/camofox_screenshot滚动与独立截图camofox_evaluate在页面上下文执行 JS提取数据camofox_list_tabs/camofox_close_tab标签页管理camofox_import_cookies导入 Netscape 格式 Cookie跳过交互式登录最佳实践所有交互遵循先快照、再操作的节奏——create_tab→snapshot拿到元素引用 → 用e1/e2这类稳定引用去click/type→ 再次snapshot确认状态 → 用完close_tab。相比 CSS 选择器元素引用无歧义选择器匹配到多个元素会返回422 strict mode violation此时重新快照改用引用即可。九、常见问题排查清单症状原因与解法503 session_expired/ tab create timed outREST 服务器会话已失效重启npm start422 strict mode violation … resolved to N elementsCSS 选择器匹配多个元素重新 snapshot 后改用元素引用点击403仅 Cookie 导入REST 与 MCP 两侧的CAMOFOX_API_KEY不一致401/403所有工具REST 服务器设置了CAMOFOX_ACCESS_KEYMCP 侧必须配置同一个值camofox_scroll返回 ok 但页面没动懒加载/虚拟滚动页面的已知行为改用camofox_evaluate执行window.scrollTo 更深入的 API 细节可查阅仓库内的 docs/api.html 与自动生成的 openapi.json完整接入说明在 mcp/README.md。写在最后从 clone 到接入 Claude Code / Cursor / Codex整个流程就是起一个 REST 服务 注册一个 MCP 命令两件事全程不到五分钟。配置完成后你的 AI 编程助手就拥有了一个能绕过反爬、Token 消耗比原始 HTML 小约 90% 的隐身浏览器——去让它帮你查页面、抓数据、跑端到端验证吧。【免费下载链接】camofox-browserStealth headless browser for AI agents — bypass Cloudflare, bot detection, and anti-scraping. Drop-in Puppeteer/Playwright replacement.项目地址: https://gitcode.com/GitHub_Trending/ca/camofox-browser创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考