browser-use MCP server
2025.03.08
1
Python浏览器自动化AI 驱动自然语言控制浏览器自动化
mcp-browser-use 是一个基于 Model Context Protocol (MCP) 的 AI 驱动浏览器自动化服务器，旨在通过自然语言控制浏览器行为。它提供了丰富的浏览器自动化功能，包括页面导航、表单填写、元素交互等，并支持多种大型语言模型（LLM）的集成。
View on GitHub
Overview
基本能力
产品定位
mcp-browser-use 是一个 AI 驱动的浏览器自动化服务器，通过 MCP 协议实现自然语言控制浏览器行为，适用于需要自动化浏览器操作的场景。
核心功能
- MCP 集成：完整的 MCP 协议实现，支持 AI 代理通信
- 浏览器自动化：页面导航、表单填写、元素交互
- 视觉理解：截图分析和基于视觉的交互
- 状态持久化：在任务之间保持浏览器会话
- 多 LLM 支持：支持 OpenAI、Anthropic、Azure、DeepSeek 等多种模型
适用场景
- 自动化测试
- 数据抓取
- 网页内容自动化操作
- AI 驱动的浏览器交互
工具列表
- uv：快速 Python 包安装工具
- Chrome/Chromium：浏览器支持
- npx @modelcontextprotocol/inspector：调试工具
常见问题解答
- 浏览器冲突：启动前关闭所有 Chrome 实例
- API 错误：确保环境变量中的 API 密钥与 LLM 提供商匹配
- 视觉支持：确保
MCP_USE_VISION=true以启用截图分析
使用教程
使用依赖
- Python 3.11 或更高版本
- uv（快速 Python 包安装工具）
- Chrome/Chromium 浏览器
安装教程
Claude Desktop
在 MacOS 上：~/Library/Application\ Support/Claude/claude_desktop_config.json
在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json
"mcpServers": {
"browser-use": {
"command": "uvx",
"args": [
"mcp-server-browser-use",
],
"env": {
"OPENROUTER_API_KEY": "",
"OPENROUTER_ENDPOINT": "https://openrouter.ai/api/v1",
"OPENAI_ENDPOINT": "https://api.openai.com/v1",
"OPENAI_API_KEY": "",
"ANTHROPIC_ENDPOINT": "https://api.anthropic.com",
"ANTHROPIC_API_KEY": "",
"GOOGLE_API_KEY": "",
"AZURE_OPENAI_ENDPOINT": "",
"AZURE_OPENAI_API_KEY": "",
"DEEPSEEK_ENDPOINT": "https://api.deepseek.com",
"DEEPSEEK_API_KEY": "",
"MISTRAL_API_KEY": "",
"MISTRAL_ENDPOINT": "https://api.mistral.ai/v1",
"OLLAMA_ENDPOINT": "http://localhost:11434",
"ANONYMIZED_TELEMETRY": "true",
"BROWSER_USE_LOGGING_LEVEL": "info",
"CHROME_PATH": "",
"CHROME_USER_DATA": "",
"CHROME_DEBUGGING_PORT": "9222",
"CHROME_DEBUGGING_HOST": "localhost",
"CHROME_PERSISTENT_SESSION": "false",
"BROWSER_HEADLESS": "false",
"BROWSER_DISABLE_SECURITY": "false",
"BROWSER_WINDOW_WIDTH": "1280",
"BROWSER_WINDOW_HEIGHT": "720",
"BROWSER_TRACE_PATH": "trace.json",
"BROWSER_RECORDING_PATH": "recording.mp4",
"RESOLUTION": "1920x1080x24",
"RESOLUTION_WIDTH": "1920",
"RESOLUTION_HEIGHT": "1080",
"VNC_PASSWORD": "youvncpassword",
"MCP_MODEL_PROVIDER": "anthropic",
"MCP_MODEL_NAME": "claude-3-5-sonnet-20241022",
"MCP_TEMPERATURE": "0.3",
"MCP_MAX_STEPS": "30",
"MCP_USE_VISION": "true",
"MCP_MAX_ACTIONS_PER_STEP": "5",
"MCP_TOOL_CALL_IN_CONTENT": "true"
}
}
本地开发
"browser-use": {
"command": "uv",
"args": [
"--directory",
"/path/to/mcp-browser-use",
"run",
"mcp-server-browser-use"
],
"env": {
...
}
}
调试方式
# 安装开发依赖
uv sync
# 使用调试器运行
npx @modelcontextprotocol/inspector uv --directory . run mcp-server-browser-use