Camoufox MCP

🦊 迷彩MCP

AI代理的反检测浏览器自动化

](https://npmjs.org/package/camoufox-mcp) ](https://npmjs.org/package/camoufox-mcp)  ](https://nodejs.org/)

用于浏览器自动化的MCP服务器 迷彩 -反检测Firefox浏览器。

安装

npx camoufox-mcp

Claude桌面配置

增添 claude_desktop_config.json:

基础：

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

使用代理（通过env变量）：

{
  "mcpServers": {
    "camoufox": {
      "command": "npx",
      "args": ["camoufox-mcp"],
      "env": {
        "PROXY_SERVER": "http://1.2.3.4:8080",
        "PROXY_USER": "username",
        "PROXY_PASS": "password"
      }
    }
  }
}

然后在 ~/.config/camoufox-mcp/settings.json:

{
  "proxy": {
    "enabled": true,
    "server": "${PROXY_SERVER}",
    "username": "${PROXY_USER}",
    "password": "${PROXY_PASS}",
    "geoip": true
  }
}

为什么选择迷彩MCP？

工具

会话管理

会话提供独立的浏览器上下文——每个会话都有自己的Cookie、本地存储和缓存。使用会话同时运行多个经过身份验证的配置文件。

页面管理

导航与交互

检查

上下文注入

监控

效用

会话

会话允许并行运行多个经过身份验证的配置文件。每个会话都是一个独立的浏览器上下文，具有自己的Cookie和localStorage。

Browser (single Camoufox instance)
  ├── Session "github" (cookies from github.json)
  │     ├── Page: github.com
  │     └── Page: github.com/repo
  ├── Session "linkedin" (cookies from linkedin.json)
  │     └── Page: linkedin.com/feed
  └── Session "default" (no pre-loaded state)
        └── Page: example.com

使用示例

使用预加载的身份验证创建会话：

1. create_session 随着 contextPath: "github-cookies.json" --返回a sessionId
2. new_page 随着 url: "https://github.com" 和那个 sessionId --打开已登录的GitHub

同时运行两个帐户：

1. create_session 随着 contextPath: "account1.json" --会话A
2. create_session 随着 contextPath: "account2.json" --会议B
3. new_page 在会话A中--以帐户1登录
4. new_page 在会话B中--以帐户2登录

保存会话状态以备后用：

1. 在会话中手动登录
2. save_session 随着 outputPath: "my-session.json" --导出Cookie+本地存储
3. 下一次， create_session 随着 contextPath: "my-session.json" --已恢复

上下文文件格式

上下文文件使用 剧作家的storageState格式:

{
  "cookies": [
    {
      "name": "session_id",
      "value": "abc123",
      "domain": ".example.com",
      "path": "/",
      "expires": 1735689600,
      "httpOnly": true,
      "secure": true,
      "sameSite": "Lax"
    }
  ],
  "origins": [
    {
      "origin": "https://example.com",
      "localStorage": [
        { "name": "token", "value": "xyz789" }
      ]
    }
  ]
}

在设置中注册上下文文件

将上下文文件路径添加到 settings.json 通过以下方式使其可被发现 list_context_files。会话已创建 懒洋洋地按要求 --在代理调用之前，不会使用内存 create_session:

{
  "contextPaths": [
    "/path/to/github-cookies.json",
    "/path/to/linkedin-cookies.json"
  ]
}

然后，代理人可以致电 list_context_files 看看有什么可用的，以及 create_session 与所需 contextPath 在需要时加载它。

设置

创建 ~/.config/camoufox-mcp/settings.json:

{
  "browser": {
    "headless": false,
    "viewport": [1280, 1080],
    "timeout": 30000,
    "humanize": 0.5
  },
  "proxy": {
    "enabled": true,
    "server": "http://proxy.example.com:8080",
    "username": "user",
    "password": "pass",
    "geoip": true
  },
  "contextPaths": []
}

代理示例

HTTP/HTTPS代理：

{ "proxy": { "enabled": true, "server": "http://1.2.3.4:8080" } }

SOCKS5代理：

{ "proxy": { "enabled": true, "server": "socks5://1.2.3.4:1080" } }

使用身份验证（使用env变量）：

{
  "proxy": {
    "enabled": true,
    "server": "${PROXY_SERVER}",
    "username": "${PROXY_USER}",
    "password": "${PROXY_PASS}",
    "geoip": true
  }
}

geoip: true 根据代理IP位置自动调整浏览器时区/区域设置。

查看更多

• 迷彩 -反检测Firefox浏览器
• camofox js -JavaScript/TypeScript绑定

许可证

麻省理工学院