QuantumProxies MCP Server 用于把 QuantumProxies 的住宅代理能力接入 AI 智能体，让 Claude、Cursor 和其他 MCP 客户端获得实时网页访问能力。
一、主要用途 它面向需要网页数据的 AI 代理场景：通过住宅代理与真实浏览器 TLS 指纹抓取、搜索、映射和爬取页面，使原本拦截普通机器人的页面也能返回干净内容。同时，它把活跃套餐中的各类原始代理端点（住宅、移动、数据中心、ISP、IPv6）交给智能体，可直接接入任意 HTTP 客户端。
二、主要能力
- 抓取（scrape）：将页面抓取为 Markdown。
- SERP 搜索：进行搜索。
- 站点地图（map）与爬取（crawl）。
- 代理生成：住宅、移动、数据中心、ISP、IPv6 代理，支持国家/城市/ASN 定位，轮换或粘性会话，HTTP 或 SOCKS5。
- 内置现成的收集器（collectors）。 官方描述中提到 25 个工具；后文又提到 28 个工具定义约 14,000 tokens。
三、使用方式 本地运行无需安装，npx 按需获取 quantumproxies-mcp（需 Node.js 18+）。 Claude Code 使用一条命令；Claude Desktop、Cursor 或任意 MCP 客户端可写入 claude_desktop_config.json、.cursor/mcp.json 或 .mcp.json。 同一服务器也可作为托管 Streamable HTTP 远程端点运行，供偏好 URL 的客户端使用。 支持 OAuth 连接：端点支持 MCP 授权规范（OAuth 2.1）。在支持的客户端中，把托管 URL 添加为远程服务器即可，客户端会打开 QuantumProxies.io 登录页，登录或创建免费账户后点击允许访问，连接完成；一个名为 MCP · <client> 的密钥会出现在仪表盘 API keys 页面，删除它即可断开客户端。底层涉及授权服务器元数据、受保护资源元数据、动态客户端注册（RFC 7591）与 Client ID Metadata Documents、必须的 PKCE（S256）、1 小时访问令牌与轮换刷新令牌、令牌绑定该端点（RFC 8707）。用量按余额计费。 不愿使用 OAuth 的客户端可采用 bearer token：密钥按请求放在 Authorization 头（或 X-Api-Key），服务器不存储。既无令牌也无密钥的请求会收到 401 与指向元数据的 WWW-Authenticate 头，从而让支持 OAuth 的客户端发起登录。 端点的自托管是同包中的第二个二进制；设置 QUANTUMPROXIES_API_KEY 后，它可将该账户服务于未发送凭据的调用方。也可从源码运行（开发模式），再把客户端指向本地构建。
四、适用场景与限制 适用于需要网页抓取、搜索、站点映射与爬取，以及需要生成和管理多种代理端点的 AI 代理工作流。 本地模型（Ollama、LM Studio、Qwen、Open WebUI）：28 个工具定义约 14,000 tokens，Ollama 默认 4K 上下文放不下，32K 上下文在抓第一页前就几乎损失一半空间。可加载更少工具：stdio 下设置 QUANTUMPROXIES_TOOLS=web；托管端点 URL 加 ?tools=web 并以 Bearer 头发送 API key，例如 https://api.quantumproxies.io/mcp?tools=web；名称可组合，如 ?tools=lite,collectors。 隐私与数据：服务器在本机运行，仅与公开的 QuantumProxies API（https://app.quantumproxies.io/api/v1）通信，使用你自己的 qp_live_ 密钥；每次调用携带你或智能体传入的参数（目标 URL 或查询，以及任何提取提示），不读取或传输本机其他内容，无文件系统、shell 或剪贴板访问。账户数据与请求日志（目标 URL 或查询、时间戳、响应状态、传输字节数、所用 API key）用于计费、防滥用和支持；除返回结果所需外不保留抓取页面内容。你不会出售个人数据，仅与服务处理方及上游代理网络（仅连接元数据）共享；账户数据在账户存续期间保留，请求日志滚动窗口保留，可随时请求删除。API key 由 Claude Desktop 存入操作系统钥匙串并作为环境变量传给服务器，不会写入包内，也不会发往除 QuantumProxies API 之外的地方，可在 https://app.quantumproxies.io/api-keys 撤销或轮换。 示例提示包括：抓取 example.com 的定价页并给出套餐与价格；在美国搜索 Google Shopping 的“nintendo switch oled”并列出最便宜 5 个；映射 docs.example.com 后仅爬取 /guides/ 页面并总结；列出代理套餐并生成 5 个粘性美国住宅代理 socks5 URL；获取德国轮换移动代理并将服务器 IP 203.0.113.7 加入白名单。 联系邮箱：support@quantumproxies.io。完整隐私政策：https://quantumproxies.io/privacy。
参数与定价、具体工具清单等细节暂未在资料中完整提供。
