模型上下文协议 (MCP)

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

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

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

开源与注册表： 在以下位置查看源代码： GitHub。该服务器已正式注册到 MCP 注册表 (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	从任何 URL 通过 AI 提取数据（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 工具生成自定义提取架构	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 内置配置编辑器使用本地（command）服务器。对于托管端点，请使用带有上述 HTTP 命令的 Claude Code，或者 在本地运行服务器 并将 Claude Desktop 指向该配置。

Cursor

1. 打开 Cursor 设置 → 自定义 在侧边栏中 → MCP
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. 保存，然后确认服务器已在以下位置启用： 自定义 → MCP.

注意： 用户 写入到 ~/.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 设置 → 自定义 在侧边栏中 → MCP
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. 保存，然后确认服务器已在以下位置启用： 自定义 → MCP.

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

验证设置

连接后，向您的助手询问需要实时网络数据的内容（例如 “抓取 https://ip.oxylabs.io 并以 Markdown 形式返回内容。”):

1

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

2

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

3

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

故障排除

错误	解决方案
客户端中缺少服务器	编辑配置后重启应用。确认 JSON 有效。
工具已列出但调用失败	占位符凭据、Base64 错误，或该工具缺少标头/环境变量。
无法连接托管 URL	客户端可能不支持自定义标头，请使用本地设置。
uvx / command not found	安装 uv 并确保其位于您的 PATH.
Cursor UI 路径看起来不同	跳过 UI，直接编辑 mcp.json （标签可能因 Cursor 版本而异）。

如有问题或功能请求，请在 GitHub 提交 issue，或联系 Oxylabs 的 24/7 支持团队： [e-mail].