氧元素-MCP

Name: 氧元素-MCP
Author: oxylabs

作者：oxylabs71 星标更新：2025-11-18

项目介绍

<p align="center"> <img src="https://storage.googleapis.com/oxylabs-public-assets/oxylabs_mcp.svg" alt="Oxylabs + MCP"> </p> <h1 align="center" style="border-bottom: none;"> Oxylabs MCP 服务器 </h1> <p align="center"> <em>连接AI模型与真实网络世界的缺失环节：一个API，从任何网站获取干净、结构化的数据。</em> </p> <div align="center">

📖 概述

Oxylabs MCP 服务器提供了AI模型与网络之间的桥梁。它使它们能够抓取任何URL，渲染JavaScript密集型页面，提取并格式化内容供AI使用，绕过反爬虫措施，并访问来自195多个国家的地理限制网络数据。

🛠️ MCP 工具

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

Oxylabs 网页抓取器API工具

universal_scraper：使用Oxylabs网页抓取器API进行通用网站抓取；
google_search_scraper：使用Oxylabs网页抓取器API从Google搜索中提取结果；
amazon_search_scraper：使用Oxylabs网页抓取器API抓取Amazon搜索结果页面；
amazon_product_scraper：使用Oxylabs网页抓取器API从单个Amazon产品页面中提取数据。

Oxylabs AI Studio工具

ai_scraper：使用AI驱动的数据提取功能，以JSON或Markdown格式从任何URL抓取内容；
ai_crawler：基于提示，爬取网站并在多个页面上收集Markdown或JSON格式的数据；
ai_browser_agent：基于提示控制浏览器，并返回Markdown、JSON、HTML或截图格式的数据；
ai_search：使用AI驱动的内容提取功能搜索网络上的URL及其内容。

✅ 先决条件

开始之前，请确保您至少拥有以下之一：

Oxylabs网页抓取器API账户：从 Oxylabs 获取您的用户名和密码（提供一周免费试用）；
Oxylabs AI Studio API密钥：从 Oxylabs AI Studio 获取您的API密钥（提供1000积分免费）。

📦 配置

环境变量

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

名称	描述	默认值
`OXYLABS_USERNAME`	您的Oxylabs网页抓取器API用户名
`OXYLABS_PASSWORD`	您的Oxylabs网页抓取器API密码
`OXYLABS_AI_STUDIO_API_KEY`	您的Oxylabs AI Studio API密钥
`LOG_LEVEL`	返回给客户端的日志级别	`INFO`

根据提供的凭证，服务器会自动暴露相应的工具：

如果仅提供 OXYLABS_USERNAME 和 OXYLABS_PASSWORD，服务器将暴露Web抓取器API工具；
如果仅提供 OXYLABS_AI_STUDIO_API_KEY，服务器将暴露AI Studio工具；
如果同时提供 OXYLABS_USERNAME 和 OXYLABS_PASSWORD 以及 OXYLABS_AI_STUDIO_API_KEY，服务器将暴露所有工具。

❗❗❗ 重要提示：如果您没有Web抓取器API或Oxylabs AI Studio凭证，请删除相应的环境变量占位符。保留占位符值会导致暴露无法工作的工具。

使用uvx配置

安装uvx包管理器：

# macOS 和 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 和 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/@oxylabs/oxylabs-mcp；
点击 Auto 安装相应的客户端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桌面

导航至 Claude → 设置 → 开发者 → 编辑配置 并将上述配置之一添加到 claude_desktop_config.json 文件中。

手动设置与Cursor AI

导航至 Cursor → 设置 → Cursor设置 → MCP。点击 添加新的全局MCP服务器 并添加上述配置之一。

📝 日志记录

服务器通过 notification/message 事件提供关于工具调用的附加信息

{
  "method": "notifications/message",
  "params": {
    "level": "info",
    "data": "创建作业参数：{\"url\": \"https://ip.oxylabs.io\"}"
  }
}

{
  "method": "notifications/message",
  "params": {
    "level": "info",
    "data": "作业信息：job_id=7333113830223918081 job_status=完成"
  }
}

{
  "method": "notifications/message",
  "params": {
    "level": "error",
    "data": "错误：请求Oxylabs API失败"
  }
}

🛡️ 许可证

根据MIT许可证分发——详情见 LICENSE。

关于Oxylabs

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

<div align="center"> <sub> 由 <a href="https://oxylabs.io">Oxylabs</a> 制作。如果您觉得MCP为您节省了一个周末，请随意给我们一个⭐。 </sub> </div>

✨ 主要特点

<details> <summary><strong>从任何站点抓取内容</strong></summary> <br>

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

</details> <details> <summary><strong>自动获取AI准备数据</strong></summary> <br>

自动清理并转换HTML为Markdown以提高可读性
使用自动化解析器处理Google、Amazon等热门目标

</details> <details> <summary><strong>绕过阻止及地理限制</strong></summary> <br>

使用全球代理网络以高成功率绕过复杂的机器人保护系统
可靠地抓取甚至最复杂的网站
从覆盖195多个国家的代理池中自动轮换IP地址

</details> <details> <summary><strong>灵活设置及跨平台支持</strong></summary> <br>

如需设置渲染和解析选项
直接将数据馈送到AI模型或分析工具
支持macOS、Windows和Linux

</details> <details> <summary><strong>内置错误处理和请求管理</strong></summary> <br>

综合错误处理和报告
智能速率限制和请求管理

</details>

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

想象一下告诉您的LLM："总结最新的Hacker News关于GPT-5的讨论" —— 它只需回答。MCP（多客户端代理）通过为您完成枯燥的部分来实现这一点：

Oxylabs MCP 做什么	对您有何意义
绕过反机器人墙使用Oxylabs全球代理网络	保持您未被封锁且匿名
在无头Chrome中渲染JavaScript	单页应用，搞定
清理HTML → JSON	直接放入向量数据库或提示中
可选结构化解析器（Google、Amazon等）	一键访问热门目标

mcp-name: io.oxylabs/oxylabs-mcp