与 MCP 的集成

本指南解释如何集成 Oxylabs 网页解锁器 (Unblocking Browser) 与 MCP（模型上下文协议），以使 AI 系统能够与远程浏览器交互并控制其行为。

访问 Oxylabs 的 GitHub 仓库以获取一个完整的可运行示例，演示 Oxylabs 网页解锁器与 MCP 的集成。

概览

模型控制协议 (MCP) 允许像 Claude 这样的 AI 系统与浏览器交互并执行基于网络的任务。通过将 Oxylabs 网页解锁器 (Unblocking Browser) 与 MCP 集成，您可以利用 AI 系统执行 网页导航、数据检索和自动化 任务，使用具有高级隐匿能力的远程浏览器并且 住宅代理 (Residential Proxy) 集成。

MCP 主机（例如 Claude Desktop 或 Cursor）自带内置的 MCP 客户端。Playwright-MCP 充当 MCP 服务器，并且它不是使用本地浏览器，而是通过安全的 WebSocket 连接（WSS）连接到网页解锁器。

快速开始

在设置集成之前，请确保您具备：

1. Oxylabs 帐户：获取用于 Oxylabs 网页解锁器的用户名和密码。

目前，您可以通过我们的销售团队获取网页解锁器，联系方式为 [email protected].

1. Node.js：版本 18.0.0 或更高（包含 npm/npx）

• Windows：从以下位置下载并安装 nodejs.org

• macOS：使用 Homebrew（brew install node）或从以下位置下载 nodejs.org

• Linux:

  • Ubuntu/Debian： sudo apt update && sudo apt install nodejs npm

  • Fedora： sudo dnf install nodejs npm

  • 或从以下位置下载 nodejs.org

1. MCP 主机：已安装 Claude Desktop 或 Cursor 中的任意一项。

配置 MCP 服务器

创建包含您 Oxylabs 凭证的 MCP 服务器配置块。将 <username> 和 <password> 替换为您实际的 Oxylabs 凭证：

"oxylabs_unblocking_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://<username>:<password>@ubc.oxylabs.io"
  ]
}

选项 1：与 Cursor 集成

1. 打开 Cursor

2. 打开 Cursor 设置

3. 选择 MCP

4. 添加准备好的 MCP 服务器配置

5. 重启 Cursor

选项 2：与 Claude Desktop 集成

1. 打开 Claude Desktop

2. 打开 Claude Desktop 设置

3. 导航到 Developer（开发者）

4. 按 编辑配置

5. 编辑 claude_desktop_config.json 文件

6. 添加准备好的 MCP 服务器配置

7. 重启 Claude Desktop

高级配置选项

国家选择

您可以通过在连接 URL 中添加以下内容，为浏览器会话指定国家： ?p_cc 参数到您的连接 URL：

"oxylabs_unblocking_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://<username>:<password>@ubc.oxylabs.io?p_cc=US"
  ]
}

将 US 替换为您想要的 ISO-3166 国家代码。如果未指定国家，系统将根据可用性自动分配。

您可以在以下位置找到 ISO-3166 国家代码 此处.

基于美国的基础设施

对于主要在美国运营的用户，您可以直接连接到美国的基础设施以获得更快的加载时间：

"oxylabs_unblocking_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://<username>:<password>@ubc-us.oxylabs.io"
  ]
}

此方案主要缩短美国用户的响应时间，不应将其与代理地理位置选择相混淆。

浏览器参数（仅限 Chrome）

对于基于 Chrome 的网页解锁器，您可以使用 bargs 参数来压制警告/错误：

"oxylabs_unblocking_browser": {
  "command": "npx",
  "args": [
    "@playwright/mcp@latest",
    "--cdp-endpoint",
    "wss://<username>:<password>@ubc.oxylabs.io/?bargs=force-color-profile:srgb&bargs=window-position:100,100"
  ]
}

支持的参数包括：

• force-color-profile:<profile>：强制将所有显示器视为具有指定的颜色配置文件

• window-position:X,Y：指定初始窗口位置

• hide-scrollbars：防止为网页内容创建滚动条

• enable-features:<feature1>,<feature2>,<feature3>：以逗号分隔的要启用的功能名称列表

• disable-notifications：禁用网页通知和推送 API

故障排除

如果您在集成过程中遇到问题：

1. 连接问题:

   • 验证您的 Oxylabs 凭证

   • 检查您的网络连接

   • 确保防火墙未阻止 WebSocket 连接

2. 性能问题:

   • 对于基于美国的用户，尝试使用美国专用端点

   • 如有需要，在您的配置中增加超时时间

3. 浏览器无法加载:

   • 检查 Node.js 版本（必须为 18.0.0 或更高）

   • 确认 npx 已正确安装

   • 重启 MCP 主机应用程序