AI导哈

隐身浏览器服务

Camoufox MCP Browser是一款基于Model Context Protocol（MCP）的隐身浏览器服务，专为AI代理提供防检测的网页浏览能力，支持持久会话和详细内容检查。

  • by danielmiranda
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 danielmiranda/camoufox-browser-mcp

使用说明

🦊 迷彩MCP浏览器

A. 模型上下文协议（MCP） 服务器旨在使用 迷彩 发动机。

🚀 目标

使AI代理（如Claude、GPT等）能够与现代网络交互而不会被阻止，保持持久会话，并允许对内容进行详细的视觉和结构检查。

✨ 主要特点

  • 🕵️ 先进隐形技术：基于迷彩（自定义Firefox）的引擎，具有C++级指纹欺骗功能。
  • 🔗 会话管理：基于哈希的系统，用于维护多个独立和持久的导航上下文。
  • 📸 双屏幕截图：将Base64中的屏幕截图直接返回给代理，并可选择将其保存到本地文件。
  • 🛠️ 交互工具：导航、单击、文本键入、滚动和链接提取。
  • 🐳 Docker原生：优化了容器，具有在无头模式下运行浏览器所需的所有系统依赖关系。

🛠️ 可用工具

工具 说明
browser_navigate 导航到URL并创建/重用持久会话。
browser_interact 执行以下操作 click, type, scroll_up, scroll_down.
browser_get_markdown 将当前页面转换为Markdown以提高AI令牌效率。
browser_list_links 从当前页面中提取所有链接及其描述性文本。
browser_screenshot 捕获当前视图（Base64+可选文件）。
browser_snapshot 检索会话的原始HTML内容。
browser_sessions 列出所有活动会话的哈希值。

📦 安装和使用

1.要求

  • Docker和Docker Compose。
  • Python 3.11+（运行测试脚本）。

2.使用Docker进行部署

# Clone and start
git clone https://github.com/danielmiranda/camoufox-browser-mcp.git
cd camoufox-browser-mcp
docker-compose up --build -d

3.MCP客户端中的配置（例如Claude Desktop）

将以下内容添加到配置文件中：

{
  "mcpServers": {
    "camoufox-browser": {
      "command": "docker",
      "args": ["exec", "-i", "camofox-mcp", "python", "src/mcp_server.py"]
    }
  }
}

🧪 验证测试

我们提供了示例脚本来验证集成：

  • 一般测试: python examples/test_mcp_docker.py （模拟完整的代理流）。
  • 刮擦蜂测试: python examples/scrapingbee_test.py （导航、列出链接和执行单击）。

⚠️ 当前限制

  • 资源消耗：由于它管理持久会话，内存使用量可以随着许多打开的选项卡而扩展。
  • 无头模式：尽管存在高级欺骗，但一些网站仍专门检测无头渲染（尽管Camoufox将其最小化）。
  • 网络：加载速度完全取决于Docker主机的连接性。

🗺️ 路线图（未来）

  • [ ] 人工智能优化Markdown：将网页内容直接提取为Markdown（标记保存）的工具。
  • [ ] 辅助功能树工具：基于可访问性角色而不是CSS选择器进行交互的工具。
  • [ ] 代理旋转：每个哈希会话的集成代理管理。
  • [ ] 验证码解决：与验证码解决服务集成，实现完全自主的流程。

建于❤️ AI Agent社区。

相关 MCP