Oxylabs MCP Server

Oxylabs MCP Server

The missing link between AI models and the real‑world web: one API that delivers clean, structured data from any site.

](https://smithery.ai/server/@oxylabs/oxylabs-mcp) ](https://pypi.org/project/oxylabs-mcp/)   

______________________________________________________________________

📖 概述

Oxylabs MCP服务器在人工智能模型和网络之间架起了一座桥梁。它使他们能够抓取任何URL，渲染JavaScript繁重的页面，提取和格式化AI使用的内容，绕过反抓取措施，并访问来自195多个国家的受地理限制的网络数据。

🛠️ MCP工具

Oxylabs MCP提供两套工具，可以一起使用或独立使用：

Oxylabs Web Scraper API工具

1. 通用\_ craper：使用Oxylabs Web Scraper API进行一般网站抓取；
2. google_search_scraper：使用Oxylabs Web Scraper API从谷歌搜索中提取结果；
3. amazon_search_scraper：使用Oxylabs Web Scraper API抓取亚马逊搜索结果页面；
4. 亚马逊产品\_ craper：使用Oxylabs Web Scraper API从单个亚马逊产品页面中提取数据。

Oxylabs人工智能工作室工具

1. ai_scraper：使用AI驱动的数据提取从JSON或Markdown格式的任何URL中抓取内容；
2. ai_crawler：根据提示，抓取网站并在多个页面上以Markdown或JSON格式收集数据；
3. ai浏览器代理：根据提示，控制浏览器并以Markdown、JSON、HTML或屏幕截图格式返回数据；
4. ai_search：使用人工智能内容提取在网络上搜索网址及其内容。

✅ 先决条件

在开始之前，请确保您已经 至少一个 以下内容：

• Oxylabs网络抓取器API帐户：从获取您的用户名和密码 Oxylabs （1周免费试用）；
• Oxylabs AI工作室API密钥：从获取API密钥 Oxylabs人工智能工作室。（免费1000学分）。

📦 配置

环境变量

Oxylabs MCP服务器支持以下环境变量：

根据提供的凭据，服务器将自动公开相应的工具：

• 要是…就好了 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工作室凭据，请删除相应的环境变量占位符。 保留占位符值将导致暴露的工具无法工作。

使用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",
          "//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/@氧气实验室/氧气实验室mcp；
• 点击 _自动_ 为各个客户端安装Oxylabs MCP配置；
• 或者使用以下配置：

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

• 按照说明使用Oauth2流对Oxylabs MCP进行身份验证

使用Smithery查询参数进行配置

如果您的客户端不支持Oauth2身份验证，您可以直接在url中传递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_desktop_config.json 文件。

使用Cursor AI进行手动设置

引导到 光标→ 设置→ 光标设置→ MCP。单击 添加新的全局MCP服务器 并添加上述配置之一。

📝 日志记录

服务器提供了有关中工具调用的其他信息 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许可证分发——请参阅 许可证 了解详情。

______________________________________________________________________

关于Oxylabs

Oxylabs成立于2015年，是一家市场领先的网络情报收集公司 平台，由最高的商业、道德和合规标准驱动， 使全球公司能够解锁数据驱动的洞察力。


Made with ☕ by Oxylabs. Feel free to give us a ⭐ if MCP saved you a weekend.

✨ 主要特点

Scrape content from any site

• 从任何URL提取数据，包括复杂的单页应用程序
• 使用无头浏览器支持完全渲染动态网站
• 选择完整的JavaScript渲染、仅HTML或无
• 模拟移动和桌面视口以实现逼真的渲染

Automatically get AI-ready data

• 自动清理HTML并将其转换为Markdown，以提高可读性
• 对谷歌、亚马逊等热门目标使用自动解析器

Bypass blocks & geo-restrictions

• 绕过复杂的机器人保护系统，成功率高
• 可靠地抓取即使是最复杂的网站
• 从覆盖195多个国家的代理池中自动轮换IP

Flexible setup & cross-platform support

• 如果需要，设置渲染和解析选项
• 将数据直接输入人工智能模型或分析工具
• 适用于macOS、Windows和Linux

Built-in error handling and request management

• 全面的错误处理和报告
• 智能限速和请求管理

______________________________________________________________________

为什么选择Oxylabs MCP？  🕸️ ➜ 📦 ➜ 🤖

想象一下，告诉你的法学硕士 *“总结黑客新闻关于GPT-5的最新讨论”* 它只是简单地回答。\ MCP（多客户端代理）通过为您完成无聊的部分来实现这一点：

mcp名称：io.oxylabs/oxylabs-mcp