Oxylabs MCP Server

Oxylabs + MCP

Oxylabs MCP 伺服器

AI 模型與真實世界網頁之間的缺失環節：一個能從任何網站提供乾淨、結構化資料的 API。

📖 概述

Oxylabs MCP 伺服器為 AI 模型與網頁之間提供橋樑。它讓模型能夠抓取任何網址、渲染大量使用 JavaScript 的頁面、擷取並格式化內容以供 AI 使用、管理 CAPTCHA，以及存取來自 195 個以上國家的地理限制網頁資料。

🛠️ MCP 工具

Oxylabs MCP 提供兩組可一起或獨立使用的工具：

Oxylabs Web Scraper API 工具

universal_scraper：使用 Oxylabs Web Scraper API 進行一般網站抓取；
google_search_scraper：使用 Oxylabs Web Scraper API 從 Google 搜尋擷取結果；
amazon_search_scraper：使用 Oxylabs Web Scraper API 抓取 Amazon 搜尋結果頁面；
amazon_product_scraper：使用 Oxylabs Web Scraper API 從個別 Amazon 產品頁面擷取資料。

Oxylabs AI Studio 工具

ai_scraper：透過 AI 驅動的資料擷取，從任何網址以 JSON 或 Markdown 格式抓取內容；
ai_crawler：根據提示，爬取網站並跨多個頁面以 Markdown 或 JSON 格式收集資料；
ai_browser_agent：根據提示，控制瀏覽器並以 Markdown、JSON、HTML 或螢幕截圖格式回傳資料；
ai_search：透過 AI 驅動的內容擷取，搜尋網頁網址及其內容。

✅ 先決條件

開始之前，請確保您至少具備以下其中一項：

Oxylabs Web Scraper API 帳戶：從 Oxylabs 取得您的使用者名稱與密碼（提供一週免費試用）；
Oxylabs AI Studio API 金鑰：從 Oxylabs AI Studio 取得您的 API 金鑰（提供 1000 點免費額度）。

📦 配置

環境變數

Oxylabs MCP 伺服器支援下列環境變數：

名稱	說明	預設值
`OXYLABS_USERNAME`	您的 Oxylabs Web Scraper API 使用者名稱
`OXYLABS_PASSWORD`	您的 Oxylabs Web Scraper API 密碼
`OXYLABS_AI_STUDIO_API_KEY`	您的 Oxylabs AI Studio API 金鑰
`LOG_LEVEL`	回傳給客戶端的日誌記錄層級	`INFO`

根據提供的憑證，伺服器將自動公開對應的工具：

若僅提供 OXYLABS_USERNAME 與 OXYLABS_PASSWORD，伺服器將公開 Web Scraper API 工具；
若僅提供 OXYLABS_AI_STUDIO_API_KEY，伺服器將公開 AI Studio 工具；
若同時提供 OXYLABS_USERNAME 與 OXYLABS_PASSWORD 以及 OXYLABS_AI_STUDIO_API_KEY，伺服器將公開所有工具。

❗❗❗ 重要提示：如果您沒有 Web Scraper API 或 Oxylabs AI Studio 憑證，請刪除對應的環境變數佔位符。保留佔位符值將導致公開的工具無法正常運作。

使用 uvx 配置

安裝 uvx 套件管理器：

# macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

或：

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

使用下列配置：

{
  "mcpServers": {
    "oxylabs": {
      "command": "uvx",
      "args": ["oxylabs-mcp"],
      "env": {
        "OXYLABS_USERNAME": "OXYLABS_USERNAME",
        "OXYLABS_PASSWORD": "OXYLABS_PASSWORD",
        "OXYLABS_AI_STUDIO_API_KEY": "OXYLABS_AI_STUDIO_API_KEY"
      }
    }
  }
}

使用 uv 配置

安裝 uv 套件管理器：

# macOS and Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

或：

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

使用下列配置：

{
  "mcpServers": {
    "oxylabs": {
      "command": "uv",
      "args": [
        "--directory",
        "/<Absolute-path-to-folder>/oxylabs-mcp",
        "run",
        "oxylabs-mcp"
      ],
      "env": {
        "OXYLABS_USERNAME": "OXYLABS_USERNAME",
        "OXYLABS_PASSWORD": "OXYLABS_PASSWORD",
        "OXYLABS_AI_STUDIO_API_KEY": "OXYLABS_AI_STUDIO_API_KEY"
      }
    }
  }
}

使用 Smithery Oauth2 配置

前往 https://smithery.ai/server/@oxylabs/oxylabs-mcp;
點擊 Auto 為對應的客戶端安裝 Oxylabs MCP 配置；
或使用下列配置：

  {
    "mcpServers": {
      "oxylabs": {
        "url": "https://server.smithery.ai/@oxylabs/oxylabs-mcp/mcp"
      }
    }
  }

按照指示透過 Oauth2 流程驗證 Oxylabs MCP

使用 Smithery 查詢參數配置

若您的客戶端不支援 Oauth2 驗證，您可以直接在網址中傳遞 Oxylabs 驗證參數

  {
    "mcpServers": {
      "oxylabs": {
        "url": "https://server.smithery.ai/@oxylabs/oxylabs-mcp/mcp?oxylabsUsername=OXYLABS_USERNAME&oxylabsPassword=OXYLABS_PASSWORD&oxylabsAiStudioApiKey=OXYLABS_AI_STUDIO_API_KEY"
      }
    }
  }

Claude Desktop 手動設定

前往 Claude → Settings → Developer → Edit Config，並將上述任一配置新增至 claude_desktop_config.json 檔案。

Cursor AI 手動設定

前往 Cursor → Settings → Cursor Settings → MCP。點擊 Add new global MCP server，並新增上述任一配置。

📝 日誌記錄

伺服器會在 notification/message 事件中提供有關工具呼叫的額外資訊

{
  "method": "notifications/message",
  "params": {
    "level": "info",
    "data": "Create job with params: {\"url\": \"https://ip.oxylabs.io\"}"
  }
}

{
  "method": "notifications/message",
  "params": {
    "level": "info",
    "data": "Job info: job_id=7333113830223918081 job_status=done"
  }
}

{
  "method": "notifications/message",
  "params": {
    "level": "error",
    "data": "Error: request to Oxylabs API failed"
  }
}

🛡️ 授權條款

依據 MIT 授權條款發佈 – 詳情請參閱 LICENSE。

關於 Oxylabs

Oxylabs 成立於 2015 年，是市場領先的網頁情報收集平台，秉持最高的商業、道德與合規標準，協助全球企業解鎖資料驅動的洞察。

_{由 Oxylabs 用 ☕ 打造。如果 MCP 為您省下了一個週末，歡迎給我們一顆 ⭐。}

✨ 主要功能

從任何網站抓取內容

從任何網址擷取資料，包括複雜的單頁應用程式
使用無頭瀏覽器支援完整渲染動態網站
可選擇完整 JavaScript 渲染、僅 HTML 或不渲染
模擬行動裝置與桌面視窗以實現真實渲染

自動取得 AI 就緒資料

自動清理並將 HTML 轉換為 Markdown，提升可讀性
針對 Google、Amazon 等熱門目標使用自動化解析器

管理 CAPTCHA 與地理限制

以高成功率應對複雜的自動化請求管理系統
可靠地抓取即使是最複雜的網站
從涵蓋 195 個以上國家的代理池中取得自動輪換 IP

靈活設定與跨平台支援

可依需求設定渲染與解析選項
直接將資料饋送至 AI 模型或分析工具
適用於 macOS、Windows 與 Linux

內建錯誤處理與請求管理

全面的錯誤處理與回報
智慧速率限制與請求管理

為何選擇 Oxylabs MCP？ 🕸️ ➜ 📦 ➜ 🤖

想像一下告訴您的 LLM 「摘要最新的 Hacker News 上有關 GPT‑5 的討論」 – 而它就直接回答了。
MCP（Multi‑Client Proxy）透過處理繁瑣的部分來實現這一點：

Oxylabs MCP 的功能	對您的重要性
透過 Oxylabs 全球代理網路管理自動化請求牆	實現網站存取與匿名性
在無頭 Chrome 中渲染 JavaScript	單頁應用程式，輕鬆搞定
清理 HTML → JSON	直接匯入向量資料庫或提示詞
可選的結構化解析器（Google、Amazon 等）	一行指令存取熱門目標

mcp-name: io.oxylabs/oxylabs-mcp

文件