环境变量配置

MCP_USE_OWN_BROWSER

设置为 true 以指示服务器连接到现有的浏览器实例。

CHROME_CDP

指定 Chrome 浏览器开发者工具协议（DevTools Protocol）的 URL 地址。格式如下：

http://host:port

示例配置

在 .env 文件或系统环境变量中设置以下内容：

MCP_USE_OWN_BROWSER=true
CHROME_CDP=http://localhost:9222 # 使用与 Chrome 启动相同的端口

使用说明

步骤 1：启动 Chrome 浏览器

使用 --remote-debugging-port 标志启动 Chrome：

google-chrome --remote-debugging-port=9222

如果端口 9222 已经被占用，可以选择其他端口（例如 9223），并相应更新 CHROME_CDP 环境变量。

步骤 2：配置环境变量

在启动 MCP 服务器之前，设置以下环境变量：

MCP_USE_OWN_BROWSER=true
CHROME_CDP=http://localhost:9222 # 使用与 Chrome 启动相同的端口

步骤 3：运行 MCP 服务器

按照常规流程启动 MCP 服务器：

uv run mcp-server-browser-use

注意事项

• 浏览器状态：使用 MCP_USE_OWN_BROWSER=true 时，确保 Chrome 浏览器保持打开状态。
• 端口访问：确认 CHROME_CDP URL 对 MCP 服务器是可访问的（通常为同一台机器上的 http://localhost:PORT）。
• 浏览器窗口大小：MCP 服务器将使用当前 Chrome 窗口的实际尺寸，而不是环境变量中的设置。

开发指南

# 安装开发依赖并同步项目依赖
uv sync --dev

# 安装 Playwright 浏览器
uv run playwright install

# 使用调试工具（示例：连接到本地 Chrome）
# 1. 启动 Chrome：google-chrome --remote-debugging-port=9222
# 2. 运行调试命令：
npx @modelcontextprotocol/inspector@latest \
  -e OPENROUTER_API_KEY=$OPENROUTER_API_KEY \
  -e MCP_MODEL_PROVIDER=openrouter \
  -e MCP_MODEL_NAME=anthropic/claude-3.7-sonnet \
  -e MCP_USE_OWN_BROWSER=true \
  -e CHROME_CDP=http://localhost:9222 \
  uv --directory . run mcp run src/mcp_server_browser_use/server.py
# 注意：根据需要调整超时时间（默认为 10 秒）

故障排除

• 浏览器冲突：当 MCP_USE_OWN_BROWSER=false 时，确保没有其他 Chrome 实例使用相同的用户数据目录。
• CDP 连接问题：
  • 确认 Chrome 启动时使用了 --remote-debugging-port 标志。
  • 检查 CHROME_CDP 端口是否正确，并确保没有防火墙阻止该端口的访问。
  • 确保浏览器实例仍在运行。
• API 错误：检查相关 API 密钥和配置是否正确。
• 开发者工具协议问题：确认 Chrome 浏览器版本支持所需的 DevTools 功能。

图像说明

此图展示了如何在 MCP 服务器中集成和使用自定义浏览器实例。