模型上下文协议 (MCP)

使用 Oxylabs MCP 通过网页爬虫API 和 AI Studio 为 AI 助手提供实时网页抓取、搜索和提取工具。

Oxylabs MCP 服务器将 AI 助手（Claude, Cursor，以及任何其他 模型上下文协议 客户端）连接到真实世界的网络。

连接后，你的助手可以抓取任何 URL（包括 JavaScript 渲染和地理定位），搜索网页、爬取站点，并提取结构化数据。

开源与注册表： 查看源代码于 GitHub。该服务器已正式注册到 MCP Registry (io.oxylabs/oxylabs-mcp), PyPI，以及 Smithery.

先决条件

你需要 至少一组 凭据来解锁其对应工具。提供两组即可解锁下面列出的所有工具。

凭据	获取方式	解锁
网页爬虫API username & password	Oxylabs 控制面板 （可免费试用）	网页爬虫API 工具
AI Studio API 密钥	AI Studio 设置 （包含免费额度）	AI Studio 工具

只配置你实际拥有的凭据。占位值会暴露出在调用时失败的工具。

可用工具

工具	作用	需要
universal_scraper	抓取任何 URL。可选 JavaScript 渲染、地理定位、Markdown/HTML 输出	网页爬虫API
google_search_scraper	Google 搜索结果，可选择解析为结构化 JSON	网页爬虫API
amazon_search_scraper	Amazon 搜索结果页，可选择解析	网页爬虫API
amazon_product_scraper	单个 Amazon 商品页面	网页爬虫API
ai_scraper	基于 AI 的任意 URL 提取（JSON、CSV、Markdown、TOON）	AI Studio
ai_crawler	由提示驱动的多页面爬取和数据收集	AI Studio
ai_browser_agent	由提示驱动的浏览器控制：导航、点击、填写表单	AI Studio
ai_search	网页搜索，可选包含每个结果的 Markdown 内容	AI Studio
ai_map	映射网站 URL	AI Studio
generate_schema	为 AI Studio 工具生成自定义提取 schema	AI Studio

选择连接方式

	托管服务器 （推荐）	本地服务器
安装	无	uv + uvx oxylabs-mcp
端点	https://mcp.oxylabs.io/mcp	Cursor/Claude 启动该进程
凭据	HTTP 标头	环境变量
最适合	最快设置，无需管理	离线控制、本地调试、无法发送自定义标头的客户端

方法 1：托管服务器（推荐）

连接到 Oxylabs 托管的 MCP 服务器：

https://mcp.oxylabs.io/mcp

将凭据作为请求标头传递：

凭据	标头
网页爬虫API	Authorization: Basic <base64(username:password)>
AI Studio	X-Oxylabs-AI-Studio-Api-Key: <your API key>

注意： 只包含你拥有的凭据对应的标头。

Claude Code

直接在命令行中安装：

claude mcp add --transport http oxylabs https://mcp.oxylabs.io/mcp \\
  --header "Authorization: Basic $(echo -n 'YOUR_USERNAME:YOUR_PASSWORD' | base64)" \\
  --header "X-Oxylabs-AI-Studio-Api-Key: YOUR_API_KEY"

如果你没有该凭据，则省略一个 --header 行。

Claude Desktop

Claude Desktop 内置配置编辑器使用本地（命令）服务器。对于托管端点，请使用上面的 HTTP 命令通过 Claude Code，或者 本地运行服务器 并让 Claude Desktop 指向该配置。

Cursor

1. 打开 Cursor 设置 → 自定义 在侧边栏中 → MCPs
2. 点击 + 新建
3. 选择 用户 （所有项目）或 项目 （仅工作区）
4. 将以下内容添加到打开的 mcp.json:

   {
     "mcpServers": {
       "oxylabs": {
         "url": "https://mcp.oxylabs.io/mcp",
         "headers": {
           "Authorization": "Basic <base64 of username:password>",
           "X-Oxylabs-AI-Studio-Api-Key": "YOUR_API_KEY"
         }
       }
     }
   }

5. 保存，然后确认服务器已在 自定义 → MCPs.

注意： 用户 写入到 ~/.cursor/mcp.json. 工作区 写入到 .cursor/mcp.json 在所选工作区中。如果两者定义了相同的服务器名称， 工作区 配置优先。

方法 2：本地服务器

该服务器可在我们的 PyPI 仓库.

如果尚未安装，请根据所选操作系统安装 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"

凭据作为环境变量传递（仅设置 你拥有的 那些）：

变量	描述
OXYLABS_USERNAME	网页爬虫API 用户名
OXYLABS_PASSWORD	网页爬虫API 密码
OXYLABS_AI_STUDIO_API_KEY	AI Studio API 密钥

Claude Code

claude mcp add oxylabs -- command uvx args oxylabs-mcp \\
  --env OXYLABS_USERNAME=YOUR_USERNAME \\
  --env OXYLABS_PASSWORD=YOUR_PASSWORD \\
  --env OXYLABS_AI_STUDIO_API_KEY=YOUR_API_KEY

Claude Code 的手动配置路径： ~/.config/claude/mcp.json （macOS/Linux）或 %USERPROFILE%\.config\claude\mcp.json （Windows）。JSON 结构与 Claude Desktop 相同。

Claude Desktop

1. 打开 Claude → 设置 → 开发者 → 编辑配置
2. 将以下内容添加到 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"
         }
       }
     }
   }

3. 重启 Claude Desktop

Cursor

1. 打开 Cursor 设置 → 自定义 在侧边栏中 → MCPs
2. 点击 + 新建
3. 选择 用户 （所有项目）或 项目 （仅工作区）
4. 将以下内容添加到打开的 mcp.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"
         }
       }
     }
   }

5. 保存，然后确认服务器已在 自定义 → MCPs.

注意： 用户 写入到 ~/.cursor/mcp.json. 工作区 写入到 .cursor/mcp.json 在所选工作区中。如果两者定义了相同的服务器名称， 工作区 配置优先。

验证设置

连接后，让你的助手处理一个需要实时网页数据的问题（例如 “抓取 https://ip.oxylabs.io 并将内容以 Markdown 返回。”):

1

确认 oxylabs 服务器出现在客户端的 MCP 列表中并已启用。

2

在提示时批准工具调用（默认情况下，客户端在运行 MCP 工具前会询问）。

3

如果调用失败，请检查凭据和客户端日志（Cursor： 输出 → MCP 日志).

故障排除

错误	解决方案
客户端中缺少服务器	编辑配置后重启应用。确认 JSON 有效。
列出的工具但调用失败	占位凭据、错误的 Base64，或该工具缺少 header/env。
托管 URL 无法连接	客户端可能不支持自定义标头，请使用本地设置。
uvx 命令未找到	安装 uv 并确保它已在你的 PATH.
Cursor 界面路径看起来不同	跳过 UI 并直接编辑 mcp.json （标签在 Cursor 版本之间可能会变化）。

如有问题或功能请求，请提交 GitHub issue，或联系 24/7 Oxylabs 支持，地址为 [e-mail].