🦊 迷彩MCP浏览器
 ](https://www.docker.com/) 
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 -d3.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社区。
