MCP Browser Use Server

🚀 MCP 服務器實現——基於瀏覽器使用

本項目實現了 MCP 協議 的具體服務，可藉助自然語言指令控制瀏覽器開展各類操作，為用戶提供便捷、高效的瀏覽器自動化解決方案。

🚀 快速開始

通過 Claude CLI 能夠輕鬆啟動服務：

# 安裝並運行服務
npx @modelcontextprotocol/cli run mcp-server-browser-use

# 查看日誌
npx @modelcontextprotocol/cli logs mcp-server-browser-use

# 在 Inspector 中打開控制檯
npx @modelcontextprotocol/inspector run mcp-server-browser-use

✨ 主要特性

• 瀏覽器控制：支持導航、點擊、輸入、滾動等常規操作。
• 表單處理：可完成填寫表單、提交請求等任務。
• 狀態查詢：能夠獲取頁面內容、進行截圖等操作。
• 多標籤管理：實現創建、切換和關閉標籤頁功能。
• 視覺識別：利用圖像識別技術定位元素。
• 模型調用：支持多種 AI 模型，提供智能決策能力。

📦 安裝指南

依賴項

項目基於以下技術構建：

環境搭建

# 克隆倉庫
git clone https://github.com/JovaniPink/mcp-browser-use.git
cd mcp-browser-use

# 創建虛擬環境並安裝依賴
python -m venv env
source env/bin/activate  # 在 Windows 中使用 env\Scripts\activate
pip install -r requirements.txt

運行服務

uvx run mcp-server-browser-use

調試模式

uvx logs --follow mcp-server-browser-use

💻 使用示例

基礎用法

通過 MCP 協議可實現以下瀏覽器功能：

# 以下為示例代碼，展示如何通過 MCP 協議實現瀏覽器操作
# 導航至指定 URL
# 模擬用戶點擊和輸入
# 提交表單數據
# 截取頁面快照
# 多標籤頁管理
# 視覺元素識別

📚 詳細文檔

配置選項

可通過配置文件或環境變量設置服務行為，以下是關鍵配置：

{
  "command": "uvx",
  "args": ["mcp-server-browser-use"],
  "env": {
    // 瀏覽器調試端口，默認 9222
    "CHROME_DEBUGGING_PORT": "9222",
    // 瀏覽器用戶數據目錄，默認空字符串使用默認配置
    "CHROME_USER_DATA": "",
    // 是否保持會話，默認 false
    "CHROME_PERSISTENT_SESSION": false,
    // 模型提供者，支持 anthropic、openai 等
    "MCP_MODEL_PROVIDER": "anthropic",
    // 其他模型參數...
  }
}

🔧 技術細節

由於服務需要控制瀏覽器行為，存在一定的安全風險。建議：

⚠️ 重要提示

• 在受信任的網絡環境下使用。
• 避免在生產環境中部署。
• 嚴格管理 API 密鑰和訪問權限。
• 定期更新依賴庫以防範漏洞。

💡 使用建議

• 保持服務與 MCP 協議的兼容性。
• 定期更新依賴庫以防範安全漏洞。
• 在生產環境前進行充分測試。
• 遵守相關法律法規和用戶隱私政策。

更多詳細信息請參考 MCP 協議文檔 和 Claude CLI 文檔。