Browser Use Claude MCP

🚀 瀏覽器使用Claude MCP

本項目是一個為AI模型（如Claude和Gemini 2.5）實現瀏覽器自動化的MCP服務器，可通過自然語言指令提供網頁瀏覽功能，讓AI助手能更智能地與網頁交互。

🚀 快速開始

本項目實現了Model Context Protocol（MCP）協議的服務器端，賦予AI模型瀏覽器自動化的能力，使AI助手能夠通過自然語言命令瀏覽網頁、與網站交互並提取信息。

詳細安裝步驟

參見INSTALL.md獲取詳細的安裝和設置說明。以下是快速開始指南：

1. 克隆倉庫

   git clone https://github.com/jasondsmith72/Browser-use-claude-mcp.git
   cd Browser-use-claude-mcp
   

2. 安裝依賴項

   npm install
   

3. 創建.env文件（以.env.example為模板）

   cp .env.example .env
   

4. 構建項目

   npm run build
   

5. 啟動服務器

   npm start
   

配置說明

參考.env.example文件，可通過環境變量進行配置。例如：

• CHROME_PATH：指定Chrome瀏覽器的路徑
• HEADLESS_CHROME：是否啟用無頭模式（true/false）

在Claude Desktop中使用

在Claude Desktop中使用本項目，請按照以下步驟操作：

1. 打開配置文件，通常位於~/.config/claude/settings.json
2. 添加MCP服務器配置：

   {
     "mcpServers": [
       {
         "name": "Browser Use Claude",
         "url": "http://localhost:3000"
       }
     ]
   }
   

3. 啟動Claude Desktop並選擇新添加的MCP服務器

✨ 主要特性

🌐 瀏覽器自動化功能

• 具備完整的瀏覽器自動化能力，涵蓋導航、表單填寫、點擊等操作。
• 支持網頁搜索功能。
• 可進行頁面截圖，以便獲取視覺理解。
• 能夠進行內容提取和分析。

🤖 AI相關功能

• 支持多種AI提供商：
  • Google Gemini 2.5（主要支持）
  • Anthropic Claude
  • OpenAI
• 支持圖像分析（視覺處理）。
• 具備AI驅動的內容分析能力。

🔧 技術特性

• 使用TypeScript編寫，確保代碼可靠性。
• 採用模塊化架構，職責分離明確。
• 擁有全面的日誌記錄和錯誤處理機制。
• 環境變量配置簡單易用。

📦 可用工具

💻 使用示例

基礎用法

瀏覽網頁

// 示例：訪問Google
await browserUseClaude.browseWeb('https://www.google.com');

搜索功能

// 示例：搜索“人工智能”
await browserUseClaude.searchWeb('人工智能');

📚 開發與測試

1. 以開發模式運行

   npm run dev
   

2. 執行測試

   npm test
   

3. 運行Linter檢查代碼風格

   npm run lint
   

📄 許可證

項目採用MIT License。

致謝

感謝社區和開源項目的貢獻，使此項目得以實現。