Browsercat MCP Server

🚀 瀏覽器貓 MCP 服務器

瀏覽器貓 MCP 服務器是一個模型上下文協議服務器，藉助 BrowserCat 的雲瀏覽器服務實現瀏覽器自動化功能。它讓大語言模型（LLM）無需安裝本地瀏覽器，就能在真實的瀏覽器環境中與網頁交互、截取截圖以及執行 JavaScript。

🚀 快速開始

若要使用瀏覽器貓 MCP 服務器，需配置相應的環境變量和 NPX 配置，具體步驟如下：

環境變量

BrowserCat MCP 服務器需要以下環境變量：

• BROWSERCAT_API_KEY：您的 BrowserCat API 密鑰（必需）。您可以在 https://browsercat.xyz/mcp 免費獲取一個。

NPX 配置

{
  "mcpServers": {
    "browsercat": {
      "command": "npx",
      "args": ["-y", "@browsercatco/mcp-server"],
      "env": {
        "BROWSERCAT_API_KEY": "your-api-key-here"
      }
    }
  }
}

✨ 主要特性

• 基於雲的瀏覽器自動化
• 無需本地安裝瀏覽器
• 控制檯日誌監控
• 截圖功能
• JavaScript 執行能力
• 基本網頁交互（導航、點擊、表單填寫）

📦 安裝指南

安裝前，請確保已配置好環境變量和 NPX 配置。具體安裝步驟可參考上述“快速開始”部分。

💻 使用示例

基礎用法

以下是使用 browsercat_navigate 工具的示例代碼：

# 假設存在一個調用工具的函數 call_tool
call_tool('browsercat_navigate', {'url': 'https://example.com'})

高級用法

以下是結合多個工具實現複雜操作的示例代碼：

# 導航到網頁
call_tool('browsercat_navigate', {'url': 'https://example.com'})

# 填寫表單
call_tool('browsercat_fill', {'selector': 'input[type="text"]', 'value': 'example text'})

# 點擊按鈕
call_tool('browsercat_click', {'selector': 'button[type="submit"]'})

# 截取截圖
call_tool('browsercat_screenshot', {'name': 'example_screenshot'})

📚 詳細文檔

組件

工具

資源

服務器提供以下兩種類型的資源：

1. 控制檯日誌 (console://logs)
   • 瀏覽器控制檯輸出文本格式的日誌
   • 包含瀏覽器的所有控制檯消息
2. 截圖 (screenshot://<name>)
   • 頁面的 PNG 圖像截屏
   • 通過截屏名稱訪問指定的截圖

📄 許可證

此 MCP 服務器根據 MIT 許可證發佈。這意味著您可以自由地使用、修改和分發軟件，但需遵守 MIT 許可證的條款和條件。有關詳細信息，請參閱項目存儲庫中的 LICENSE 文件。