← 返回目录

Oxylabs MCP Server

官方

已归档

连接AI模型与真实网页的桥梁：一个API即可从任何网站获取干净、结构化的数据。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他
Stars: ★ 104 热门
传输方式: stdio（本地进程）
运行环境: Python · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 34 天前
工具数: 8

59FMRS · C

Oxylabs MCP Server提供了强大的抓取和AI数据提取功能，适合需要高效获取网页数据的开发者。优点包括支持多种目标网站、自动渲染JavaScript、内置CAPTCHA管理，以及AI驱动的工具。需要注意凭证配置和成本问题。

最强项 · 维护活跃度 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

13/20

维护活跃度

14/20

文档质量

13/20

安装易用性

11/20

查看各项评分依据

可靠性 8/20: 服务器清单显示为stdio传输，但缺少显式的命令参数（如uvx或python），这威胁到可复现的启动。清单中环境变量被标记为非必需，但README警告如果缺少对应凭据，暴露的工具将无法工作，这表明错误处理可能不佳。测试或CI工作流（如GitHub Actions）未提供；没有提交记录。因此可靠性分数限制在8分。
安全与权限 13/20: 凭据处理是安全的：环境变量被标记为秘密，且示例配置中没有真实令牌。然而，外部网络访问是预期的（调用Oxylabs API），但没有提及数据保留或第三方数据处理。工具执行远程操作（抓取），但这是核心功能，并非过度扩展。没有发现明显的不当行为，但数据边界和确认机制披露不完整，因此上限为13分。
维护活跃度 14/20: 仓库显示101颗星，仅1个未解决的问题，未被归档。MIT许可证存在，版本0.7.2表明积极发布。但未提供提交或发布频率的详细信息，也没有安全问题报告渠道。缺少这些治理细节将分数限制在14分。
文档质量 13/20: README涵盖了配置（uvx、uv、Smithery）、环境变量、工具列表和日志。但缺少详细的工具参数描述、速率限制、定价和故障排除指南。文档中关于凭据的警告很重要，但整体深度不足。因此分数为13分。
安装易用性 11/20: 安装步骤通过uvx和uv进行了说明，并提供了客户端的配置示例（Claude Desktop、Cursor）。但主要客户端的配置示例使用了占位符而非实际值，并且需要用户拥有相应账户。多个设置路径可能令人困惑，且没有提供执行验证。因此分数限制在11分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络控制浏览器

适合谁

需要从网站提取结构化数据的开发者和数据科学家
构建基于AI的网页内容分析工具
需要绕过CAPTCHA和地理限制获取数据的场景

不适合谁

没有Oxylabs账户或凭证的用户
需要处理极其复杂或高度反爬的网站（可能需要专业支持）
对成本敏感且需要无限制免费使用的用户

所需权限

需要网络访问权限以调用Oxylabs API
环境变量中存储的凭证（OXYLABS_USERNAME、OXYLABS_PASSWORD、OXYLABS_AI_STUDIO_API_KEY）

风险与副作用

凭证泄露风险：注意不要将凭证硬编码或提交到公共仓库
API密钥可能被滥用，需定期轮换
抓取操作可能违反网站服务条款，需自行评估合规性
依赖外部API，可能因网络或服务问题导致失败

安装接入

准备工作

运行环境：Python · 远程托管（无需本地环境）

OXYLABS_USERNAME 可选密钥 Oxylabs Web Scraper API 用户名，从 dashboard.oxylabs.io 获取（有 1 周免费试用）。

OXYLABS_PASSWORD 可选密钥 Oxylabs Web Scraper API 密码，与用户名配套。

OXYLABS_AI_STUDIO_API_KEY 可选密钥 Oxylabs AI Studio API 密钥，从 aistudio.oxylabs.io/settings/api-key 获取（1000 免费积分）。

其他可选配置项（1 个）

LOG_LEVEL 可选返回给客户端的日志级别，默认 INFO，可选。

安装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"。
在MCP客户端配置中添加以下JSON配置：{"mcpServers":{"oxylabs":{"command":"uvx","args":["oxylabs-mcp"],"env":{"OXYLABS_USERNAME":"你的用户名","OXYLABS_PASSWORD":"你的密码","OXYLABS_AI_STUDIO_API_KEY":"你的API密钥"}}}}。
确保提供至少一组有效凭证：要么是Web Scraper API的OXYLABS_USERNAME和OXYLABS_PASSWORD，要么是AI Studio的OXYLABS_AI_STUDIO_API_KEY。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "oxylabs": {
      "command": "uvx",
      "args": [
        "oxylabs-mcp"
      ],
      "env": {
        "OXYLABS_USERNAME": "YOUR_USERNAME",
        "OXYLABS_PASSWORD": "YOUR_PASSWORD",
        "OXYLABS_AI_STUDIO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add oxylabs -e OXYLABS_USERNAME=YOUR_USERNAME -e OXYLABS_PASSWORD=YOUR_PASSWORD -e OXYLABS_AI_STUDIO_API_KEY=YOUR_API_KEY -- uvx oxylabs-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中确认出现 universal_scraper 或 ai_search 等工具；发送一个抓取 https://ip.oxylabs.io 的请求，若返回页面内容即说明配置成功。注意：留下占位符凭证会导致暴露但不可用的工具。

常见排障

1. 确认环境变量已正确设置，且没有留空占位符（占位符会导致工具暴露但不工作）。
2. 检查网络连接，确保能访问Oxylabs API。
3. 查看服务器返回的notification/message事件中的日志，例如'Create job'和'Job info'，诊断问题。
4. 如果工具未显示，检查是否提供了正确的凭证组合：只有Web Scraper凭证时仅显示前四个工具，只有AI Studio密钥时显示后四个，两者都有则显示全部。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 universal_scraper 抓取 https://ip.oxylabs.io 的页面内容
搜索 Google 上关于 MCP 协议的最新结果并总结
抓取某个 Amazon 商品页面的价格和评论数据
根据提示词用 ai_crawler 爬取一个网站多页并输出 Markdown

工具能力 8

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产品页面提取数据。

ai_scraper 只读

使用AI驱动的数据提取，从任何URL抓取JSON或Markdown格式的内容。

ai_crawler 只读

根据提示，爬取网站并在多个页面收集Markdown或JSON格式的数据。

ai_browser_agent 只读

根据提示，控制浏览器并以Markdown、JSON、HTML或截图格式返回数据。

ai_search 只读

使用AI驱动的内容提取搜索网页的URL及其内容。

使用场景

抓取动态网站并提取数据供AI分析

获取Google、Amazon等目标平台的搜索结果

通过AI代理自动化浏览器操作

从网页收集结构化数据用于LLM训练或内容生成

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

Oxylabs MCP服务器为AI模型与网页之间提供桥梁。它能够抓取任何URL、渲染JavaScript密集型页面、提取并格式化内容以供AI使用、管理验证码，并获取来自195多个国家/地区的地理限制网络数据。