Browser-Use MCP Server

此仓库包含用于运行具有不同浏览器模式的Browser-Use MCP服务器的Docker配置。

概述

Browser-Use MCP服务器为像Claude Desktop这样的AI助手提供了浏览器自动化功能。这种设置提供了无头模式和VNC启用模式，以适应不同的使用场景。

可用模式

1. 无头模式（生产）

• 无视觉界面
• 资源消耗最小
• 适用于生产部署
• 在镜像标签后添加 -headless
• 示例：ghcr.io/andrewjedawes/browser-use-mcp-server:latest-headless

2. VNC模式（调试）

• 通过VNC访问可视化的浏览器界面
• 非常适合调试和开发
• 实时查看浏览器
• 在镜像标签后添加 -vnc
• 示例：ghcr.io/andrewjedawes/browser-use-mcp-server:latest-vnc

环境配置

对于Cursor/Claude Desktop

创建一个MCP服务器配置：

VNC：

{
	"servers": {
		"browser-use-mcp-server-vnc": {
			"command": "docker",
			"args": [
				"run",
				"-i",
				"--rm",
				"-p",
				"5900:5900",
				"-e",
				"GOOGLE_API_KEY",
				"ghcr.io/andrewjdawes/browser-use-mcp-server:latest-vnc"
			],
			"env": {
				"GOOGLE_API_KEY": "your_google_api_key_here"
			}
		}
	}
}

无头模式：

{
	"servers": {
		"browser-use-mcp-server-headless": {
			"command": "docker",
			"args": [
				"run",
				"-i",
				"--rm",
				"-e",
				"GOOGLE_API_KEY",
				"ghcr.io/andrewjdawes/browser-use-mcp-server:latest-headless"
			],
			"env": {
				"GOOGLE_API_KEY": "YOUR_API_KEY"
			}
		}
	}
}

环境变量

• DISPLAY: VNC模式下的X11显示（自动设置）

VNC访问

当使用VNC模式时：

• URL: vnc://localhost:5900
• 密码: browseruse
• 分辨率: 1024x768

VNC客户端：

• macOS: 内置屏幕共享或TigerVNC
• Windows: TigerVNC、RealVNC 或 UltraVNC
• Linux: Remmina、TigerVNC 或基于浏览器的客户端

工作原理

1. MCP通信: 容器以 -i 标志运行，用于标准输入/输出通信
2. 浏览器会话: Playwright在容器内启动Chromium
3. VNC访问: X11转发允许您看到浏览器的实际操作
4. 双模式: 同一MCP服务器，不同的可见性选项

故障排除

遇到问题时：

1. 重建镜像以获取最新的修复：

2. 验证容器是否正常工作：

   docker run --rm ghcr.io/andrewjdawes/browser-use-mcp-server:latest-headless python -c "from browser_use import BrowserSession; print('Browser-use working!')"
   

浏览器未启动

# 检查容器是否正在运行
docker ps
# 查看日志
docker logs <container_id>

将 <container_id> 替换为从 docker ps 获取的实际容器ID。

VNC连接问题

# 测试VNC端口
nc -zv localhost 5900
# 检查容器内的VNC服务器是否运行
docker exec <container_id> ps aux | grep vnc

将 <container_id> 替换为从 docker ps 获取的实际容器ID。

架构

MCP客户端（Claude Desktop）
    ↓ （标准输入/输出）
Docker容器
    ├── MCP服务器（browser-use CLI）
    ├── Playwright
    ├── Chromium浏览器
    └── VNC服务器（可选）
        ↓ （端口5900）
VNC客户端（用于调试）

使用场景

无头模式：

• 生产MCP服务器
• 自动化工作流
• 资源受限环境

VNC模式：

• 调试浏览器自动化
• 开发和测试
• 浏览器动作的可视化验证
• 展示浏览器能力

替代方案

选项3：X11转发（Linux/macOS）

# Linux
docker run -it --rm -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix browser-use-mcp-server:latest

# macOS（带有XQuartz）
xhost +localhost
docker run -it --rm -e DISPLAY=host.docker.internal:0 browser-use-mcp-server:latest