Browser Use MCP Server

🚀 環境變量配置

本項目主要用於配置 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_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 服務器中集成和使用自定義瀏覽器實例。