使用说明
卡莫福克斯mcp
MCP服务器 卡莫福克斯 --AI代理的反检测浏览器自动化。
没有启动本地浏览器。 这是运行在其他地方(Docker、远程服务器等)的CamoFox REST API上的一个精简MCP包装器。
为什么
CamoFox通过以下方式提供反检测浏览 迷彩 (带有C++指纹欺骗的Firefox分叉)。此MCP服务器允许任何与MCP兼容的AI代理(OpenClaw、Claude Desktop等)将其用作工具。
快速开始
1.在某处启动CamoFox服务器
# Docker (recommended)
docker run -p 9377:9377 jo-inc/camofox-browser
# Or standalone
git clone https://github.com/jo-inc/camofox-browser
cd camofox-browser && npm install && npm start
2.运行MCP服务器
# With uvx (no install needed)
CAMOFOX_URL=http://your-server:9377 uvx camofox-mcp
# Or install and run
pip install camofox-mcp
CAMOFOX_URL=http://your-server:9377 camofox-mcp
3.配置您的MCP客户端
OpenClaw(麦克波特)
mcporter config add camofox --stdio \
"CAMOFOX_URL=http://your-server:9377 CAMOFOX_USER=agent uvx camofox-mcp"
克劳德桌面/光标
{
"mcpServers": {
"camofox": {
"command": "uvx",
"args": ["camofox-mcp"],
"env": {
"CAMOFOX_URL": "http://your-server:9377",
"CAMOFOX_USER": "agent"
}
}
}
}
环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
CAMOFOX_URL |
http://localhost:9377 |
camofox服务器URL |
CAMOFOX_USER |
default |
会话隔离的用户ID |
CAMOFOX_TIMEOUT |
30 |
HTTP请求超时(秒) |
工具
| 工具 | 说明 |
|---|---|
camofox_health |
检查服务器状态 |
camofox_navigate |
打开URL→ 获取可访问性快照 |
camofox_snapshot |
获取当前页面快照 |
camofox_click |
按ref(e1,e2…)单击元素 |
camofox_type |
在元素中键入文本 |
camofox_press |
按键盘键 |
camofox_scroll |
滚动页面(上/下/左/右) |
camofox_navigate_tab |
将现有选项卡导航到新URL |
camofox_search |
使用搜索宏(@google_search等) |
camofox_links |
从页面中提取所有链接 |
camofox_screenshot |
截图(返回文件路径) |
camofox_tabs |
列出打开的选项卡 |
camofox_close |
关闭选项卡 |
camofox_close_all |
关闭所有选项卡 |
camofox_back |
浏览器历史记录返回 |
camofox_forward |
浏览器历史记录转发 |
搜索宏
@google_search · @youtube_search · @amazon_search · @reddit_search · @wikipedia_search · @twitter_search · @yelp_search · @spotify_search · @netflix_search · @linkedin_search · @instagram_search · @tiktok_search · @twitch_search
建筑
AI Agent ←(MCP/stdio)→ camofox-mcp ←(REST/HTTP)→ CamoFox Server ←→ Camoufox Browser
MCP服务器是无状态的——所有状态都存在于CamoFox服务器中。多个MCP客户端可以连接到具有不同配置的同一CamoFox实例 CAMOFOX_USER 会话隔离值。
安全
- 所有用户输入(URL、文本、引用)都是JSON编码的,没有shell插值
- 选项卡ID在路径中使用之前已进行URL编码
- 不会存储或传输超出CamoFox要求的凭据
- MCP服务器从不启动浏览器,它只代理现有的CamoFox实例
许可证
麻省理工学院