浏览器使用服务器
](https://smithery.ai/server/@ztobs/cline-browser-use-mcp)
使用Python脚本实现浏览器自动化的模型上下文协议服务器。与Cline一起使用
特性
浏览器操作
screenshot：捕获网页的屏幕截图（整页或视口）get_html：检索网页的HTML内容execute_js：在网页上执行JavaScriptget_console_logs：从网页获取控制台日志
所有操作都支持页面加载后的自定义交互步骤（例如，单击元素、滚动）。
先决条件
- （可选但推荐）安装Xvfb以实现无头浏览器自动化：
# Ubuntu/Debian
sudo apt-get install xvfb
# CentOS/RHEL
sudo yum install xorg-x11-server-Xvfb
# Arch Linux
sudo pacman -S xorg-server-xvfbXvfb（X虚拟帧缓冲区）创建了一个虚拟显示，允许浏览器自动化，而不会被检测为机器人。了解更多关于Xvfb的信息 这里.
- 安装Miniconda或Anaconda
- 创建Conda环境：
conda create -n browser-use python=3.11
conda activate browser-use
pip install -r requirements.txt- 设置LLM配置：
服务器支持多个LLM提供程序。您可以使用以下任意一个API密钥：
# Required: Set at least one of these API keys
export GLHF_API_KEY=your_api_key
export GROQ_API_KEY=your_api_key
export OPENAI_API_KEY=your_api_key
export OPENROUTER_API_KEY=your_api_key
export GITHUB_API_KEY=your_api_key
export DEEPSEEK_API_KEY=your_api_key
export GEMINI_API_KEY=your_api_key
export OLLAMA_API_KEY=your_api_key
# Optional: Override default configuration
export MODEL=your_preferred_model # Override the default model
export BASE_URL=your_custom_url # Override the default API endpoint
export USE_VISION=false # Enable/disable vision capabilities (default: false)服务器将自动使用它找到的第一个可用的API密钥。您可以选择使用环境变量为任何提供程序自定义模型和基本URL。
安装
通过Smithery安装
要安装浏览器，请通过以下方式自动使用克劳德桌面服务器 史密瑟里:
npx -y @smithery/cli install @ztobs/cline-browser-use-mcp --client claude- 将此存储库克隆到
/home/YOUR_HOME/Documents/Cline/目录 - 安装依赖项：
npm install- 构建服务器：
npm run buildMCP配置
将以下配置添加到Cline MCP设置中：
"browser-use": {
"command": "node",
"args": [
"/home/YOUR_HOME/Documents/Cline/MCP/browser-use-server/build/index.js"
],
"env": {
// Required: Set at least one API key
"GLHF_API_KEY": "your_api_key",
"GROQ_API_KEY": "your_api_key",
"OPENAI_API_KEY": "your_api_key",
"OPENROUTER_API_KEY": "your_api_key",
"GITHUB_API_KEY": "your_api_key",
"DEEPSEEK_API_KEY": "your_api_key",
"GEMINI_API_KEY": "your_api_key",
"OLLAMA_API_KEY": "your_api_key",
// Optional: Configuration overrides
"MODEL": "your_preferred_model",
"BASE_URL": "your_custom_url",
"USE_VISION": "false"
},
"disabled": false,
"autoApprove": []
}替换：
YOUR_HOME使用您的实际主目录名称your_api_key使用您的实际API密钥
用法
运行服务器：
node build/index.js服务器将在stdio上可用，并支持以下操作：
截图
参数：
- url：网页url（必填）
- full_page：是捕获整个页面还是仅捕获视口（可选，默认值：false）
- steps：逗号分隔的动作或句子，描述页面加载后要采取的步骤（可选）
获取HTML
参数：
- url：网页url（必填）
- steps：逗号分隔的动作或句子，描述页面加载后要采取的步骤（可选）
执行JavaScript
参数：
- url：网页url（必填）
- script:要执行的JavaScript代码（必需）
- steps：逗号分隔的动作或句子，描述页面加载后要采取的步骤（可选）
获取控制台日志
参数：
- url：网页url（必填）
- steps：逗号分隔的动作或句子，描述页面加载后要采取的步骤（可选）
临床使用示例
以下是您可以使用Cline的浏览器使用服务器完成的一些示例任务：
在开发过程中修改网页元素
要更改需要身份验证的页面上标题的颜色，请执行以下操作：
Change the colour of the headline with the text "Alle Foren im Überblick." to deep blue on https://localhost:3000/foren/ page
To check/see the page, use browser-use MCP server to:
Open https://localhost:3000/auth,
Login with ztobs:Password123,
Navigate to https://localhost:3000/foren/,
Accept cookies if required
hint: execute all browser actions in one command with multiple comma-separated steps此任务演示：
- 使用逗号分隔步骤的多步浏览器自动化
- 身份验证处理
- Cookie接受
- DOM操作
- CSS样式更改
服务器将按顺序执行这些步骤，在此过程中处理任何所需的交互。
配置
LLM配置
服务器支持多个LLM提供程序及其默认配置：
- GLHF：使用deepseek ai/deepseek-V3模型
- Ollama：使用具有32k上下文窗口的qwen2.5:32b-结构-q4_K_M模型
- Groq：使用deepseek-r1-distill-lama-70b型号
- OpenAI：使用gpt-4o-mini模型
- Openrouter：使用deepseek/deepseek聊天模型
- Github：使用gpt-4o-mini模型
- DeepSeek：使用DeepSeek聊天模式
- 双子座：使用双子座-2.0-flash-exp模型
您可以使用环境变量覆盖这些默认值：
MODEL：为任何提供程序设置自定义模型名称BASE_URL：设置自定义API终结点URL（如果提供程序支持）
视觉支持
服务器通过USE_vision环境变量支持视觉功能：
- 将USE_VISION=true设置为启用浏览器操作的视觉功能
- 当不需要视觉时，默认值为false以优化性能
- 适用于需要视觉理解网页内容的任务
Xvfb支持
服务器会自动检测是否安装了Xvfb，并：
- 在可用时使用xvfb run，在没有机器人检测的情况下实现更好的浏览器自动化
- 未安装Xvfb时回退到直接执行
- 相应地设置RUNNING_UNDER_XVFB环境变量
超时
默认超时为5分钟（300000毫秒）。修改中的TIMEOUT常数 build/index.js 改变这一点。
错误处理
服务器为以下对象提供详细的错误消息：
- Python脚本执行失败
- 浏览器操作超时
- 无效参数
调试
使用MCP检查器进行调试：
npm run inspector用途
许可证
麻省理工学院