MCP Browser Use

🚀 browser-use MCP服務器

AI驅動的瀏覽器自動化服務器，實現了用於自然語言瀏覽器控制的模型上下文協議（MCP）。此MCP服務器的實現基於 browser-use/web-ui 項目，核心的瀏覽器自動化邏輯和配置模式均借鑑自原項目。

✨ 主要特性

• 🧠 MCP集成 - 完整實現協議，用於與AI代理進行通信。
• 🌐 瀏覽器自動化 - 支持頁面導航、表單填寫和元素交互。
• 👁️ 視覺理解 - 支持截圖分析和基於視覺的交互。
• 🔄 狀態持久化 - 在任務之間保持瀏覽器會話。
• 🔌 多大語言模型支持 - 集成了OpenAI、Anthropic、Azure、DeepSeek等。

🚀 快速開始

前提條件

• Python 3.11 或更高版本
• uv（快速Python包安裝器）
• Chrome/Chromium瀏覽器

📦 安裝指南

Claude桌面版

在MacOS上：~/Library/Application\ Support/Claude/claude_desktop_config.json 在Windows上：%APPDATA%/Claude/claude_desktop_config.json

"mcpServers": {
    "browser-use": {
      "command": "uvx",
      "args": [
        "mcp-server-browser-use",
      ],
      "env": {
        "OPENROUTER_API_KEY": "",
        "OPENROUTER_ENDPOINT": "https://openrouter.ai/api/v1",
        "OPENAI_ENDPOINT": "https://api.openai.com/v1",
        "OPENAI_API_KEY": "",
        "ANTHROPIC_ENDPOINT": "https://api.anthropic.com",
        "ANTHROPIC_API_KEY": "",
        "GOOGLE_API_KEY": "",
        "AZURE_OPENAI_ENDPOINT": "",
        "AZURE_OPENAI_API_KEY": "",
        "DEEPSEEK_ENDPOINT": "https://api.deepseek.com",
        "DEEPSEEK_API_KEY": "",
        "MISTRAL_API_KEY": "",
        "MISTRAL_ENDPOINT": "https://api.mistral.ai/v1",
        "OLLAMA_ENDPOINT": "http://localhost:11434",
        "ANONYMIZED_TELEMETRY": "true",
        "BROWSER_USE_LOGGING_LEVEL": "info",
        "CHROME_PATH": "",
        "CHROME_USER_DATA": "",
        "CHROME_DEBUGGING_PORT": "9222",
        "CHROME_DEBUGGING_HOST": "localhost",
        "CHROME_PERSISTENT_SESSION": "false",
        "BROWSER_HEADLESS": "false",
        "BROWSER_DISABLE_SECURITY": "false",
        "BROWSER_WINDOW_WIDTH": "1280",
        "BROWSER_WINDOW_HEIGHT": "720",
        "BROWSER_TRACE_PATH": "trace.json",
        "BROWSER_RECORDING_PATH": "recording.mp4",
        "RESOLUTION": "1920x1080x24",
        "RESOLUTION_WIDTH": "1920",
        "RESOLUTION_HEIGHT": "1080",
        "VNC_PASSWORD": "youvncpassword",
        "MCP_MODEL_PROVIDER": "anthropic",
        "MCP_MODEL_NAME": "claude-3-5-sonnet-20241022",
        "MCP_TEMPERATURE": "0.3",
        "MCP_MAX_STEPS": "30",
        "MCP_USE_VISION": "true",
        "MCP_MAX_ACTIONS_PER_STEP": "5",
        "MCP_TOOL_CALL_IN_CONTENT": "true"
    }
}

本地開發

"browser-use": {
  "command": "uv",
  "args": [
    "--directory",
    "/path/to/mcp-browser-use",
    "run",
    "mcp-server-browser-use"
  ],
  "env": {
    ...
  }
}

📚 詳細文檔

開發

# 安裝開發依賴
uv sync

# 使用調試器運行
npx @modelcontextprotocol/inspector uv --directory . run mcp-server-browser-use

故障排除

• 瀏覽器衝突：啟動前關閉所有Chrome實例。
• API錯誤：驗證環境變量中的API密鑰是否與你的大語言模型提供商匹配。
• 視覺支持：確保 MCP_USE_VISION=true 以進行截圖分析。

提供商配置

服務器通過環境變量支持多個大語言模型提供商。以下是 MCP_MODEL_PROVIDER 的可用選項：

注意事項：

• 對於標記為可選的端點，如果未指定，將使用默認值。
• 可以使用 MCP_TEMPERATURE 配置溫度（默認值：0.3）。
• 可以使用 MCP_MODEL_NAME 指定模型。
• 對於Ollama模型，可以配置 num_ctx 和 num_predict 等額外的上下文設置。

致謝

本項目基於 browser-use/web-ui 項目進行擴展，遵循MIT許可證。特別感謝原作者提供的瀏覽器自動化框架。

📄 許可證

本項目採用MIT許可證，詳情請參閱 LICENSE。