🚀 环境变量配置
本项目主要用于配置 MCP 服务器与 Chrome 浏览器交互所需的环境变量，通过合理配置这些变量，可以实现服务器连接到现有的浏览器实例，从而完成相关操作。
🚀 快速开始
环境变量配置
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_CDPURL 对 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端口是否正确，并确保没有防火墙阻止该端口的访问。 - 确保浏览器实例仍在运行。
- 确认 Chrome 启动时使用了
- API 错误：检查相关 API 密钥和配置是否正确。
- 开发者工具协议问题：确认 Chrome 浏览器版本支持所需的 DevTools 功能。
图像说明
此图展示了如何在 MCP 服务器中集成和使用自定义浏览器实例。