ProxyCove

ProxyCove MCP 服务

让 AI Agent 购买和管理真实代理——无需注册，无需控制面板，也无需在聊天中提供银行卡信息。

ProxyCove 销售住宅、移动和数据中心代理，按 GB 预付费，覆盖 170 多个国家/地区。此 MCP 服务提供 14 个工具，因此 Agent 可以创建自己的账户、向用户提供付款链接、购买代理并获取可用的连接凭据——整个过程都能在一次对话中完成。

https://mcp.proxycove.com/mcp     ← remote endpoint (streamable HTTP)

状态：已上线。 上方端点为公开端点——可以连接并使用。 get_pricing、list_locations 和 create_account 允许匿名调用；其他所有操作都需要密钥。偏好使用 OAuth 2.1 的客户端 可通过 /.well-known/oauth-protected-resource 发现服务。

适用对象： 构建抓取／自动化／测试 Agent 的开发者、需要特定国家／地区出口 IP 的 Agent 的用户，以及希望直接调用代理提供商、而非手动封装 REST API 的 MCP 客户端。

Agent 可以端到端完成的操作

1. create_account → 获取 API 密钥（pc_live_...）。无需填写注册表单，也无需邮箱。
2. create_topup → 获取 payment_url。由用户在浏览器中付款（SBP、银行卡、加密货币）。
3. buy_proxy → 获取 http://login:[email protected]:824 并开始使用。

价格：住宅代理 $2.7/GB · 移动代理 $3.8/GB · 数据中心代理 $1.5/GB。 流量需预付费，只要账户处于活跃状态就不会过期。

---

快速开始

此服务为远程服务——无需安装。将端点添加到客户端，并在拥有密钥后将其作为 bearer token 发送。

无需密钥即可添加连接器：get_pricing、list_locations 和 create_account 支持匿名调用。运行 create_account，保存返回的 pc_live_... 密钥，将其填入标头，然后重新连接。

Claude Code

claude mcp add --transport http proxycove https://mcp.proxycove.com/mcp \
  --header "Authorization: Bearer pc_live_YOUR_KEY"

尚未获取密钥时（可先调用 create_account）：

claude mcp add --transport http proxycove https://mcp.proxycove.com/mcp

Claude Desktop / Claude.ai（连接器）

设置 → 连接器 → 添加自定义连接器

字段	值
名称	ProxyCove
远程 MCP 服务 URL	https://mcp.proxycove.com/mcp

OAuth 尚未推出之前，Claude Desktop 也可以通过 stdio 桥接访问该服务，标头就配置在这里：

{
  "mcpServers": {
    "proxycove": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.proxycove.com/mcp",
        "--header", "Authorization: Bearer pc_live_YOUR_KEY"
      ]
    }
  }
}

ChatGPT（开发者模式）

设置 → 连接器 → 高级 → 启用 开发者模式，然后点击 创建：

字段	值
名称	ProxyCove
MCP 服务 URL	https://mcp.proxycove.com/mcp
身份验证	访问令牌／API 密钥 → 粘贴 pc_live_YOUR_KEY

Cursor

~/.cursor/mcp.json（全局）或 .cursor/mcp.json（每个项目）：

{
  "mcpServers": {
    "proxycove": {
      "url": "https://mcp.proxycove.com/mcp",
      "headers": {
        "Authorization": "Bearer pc_live_YOUR_KEY"
      }
    }
  }
}

Codex CLI

~/.codex/config.toml：

[mcp_servers.proxycove]
url = "https://mcp.proxycove.com/mcp"
bearer_token_env_var = "PROXYCOVE_API_KEY"

export PROXYCOVE_API_KEY=pc_live_YOUR_KEY

其他 MCP 客户端

{
  "mcpServers": {
    "proxycove": {
      "type": "http",
      "url": "https://mcp.proxycove.com/mcp",
      "headers": {
        "Authorization": "Bearer pc_live_YOUR_KEY"
      }
    }
  }
}

传输方式为可流式 HTTP，无状态——仅支持 POST，每次调用处理一个 JSON-RPC 请求，不提供 SSE 流，也没有会话 ID。对该端点执行 GET／DELETE 会返回 405。

---

Agent 技能

除了工具说明之外，此代码仓库还附带一个 Agent 技能， 用于告诉 Agent 应该调用哪个工具：如何根据任务选择代理类型、何时需要粘性会话、每个错误代码的实际含义，以及确保用户始终掌控操作的规则——绝不处理付款信息、消费前先告知价格、保存密钥。

npx skills add proxycove/mcp-server

---

工具

工具	功能	API 密钥
get_pricing	查询住宅／移动／数据中心代理每 GB 的价格（USD）	否
list_locations	查询指定代理类型支持的国家／地区	否
create_account	无需注册表单即可创建账户，并返回 pc_live_... 密钥	否
get_account	查询余额（USD）、关联邮箱和活跃代理数量	是
create_topup	创建账单，并返回供人类使用的 payment_url	是
get_payment_status	查询账单状态：pending／paid／cancelled	是
buy_proxy	使用余额购买代理，并返回连接凭据	是
list_proxies	列出所有代理及其剩余流量和凭据	是
get_credentials	获取单个代理的连接字符串	是
extend_proxy	为现有代理增加预付流量（凭据不变）	是
get_usage	查询单个代理的实时已用／剩余流量	是
set_rotation	在每次请求更换 IP 与粘性 IP 之间切换，时长为 1–120 分钟	是
link_telegram	返回用于将账户关联到 Telegram 机器人的代码（密钥丢失时的第二种找回方式）	是
attach_recovery	关联邮箱，以便人类登录网站	是

只读工具带有 readOnlyHint。没有任何工具会删除内容——此服务没有破坏性操作，也没有工具能够将资金转出账户。

连接模式

每个代理都可通过 go.proxycove.com 访问：

端口	行为
824	每次请求都使用新的 IP
10000	粘性 IP，在设定的 1–120 分钟内保持不变

set_rotation 可在这两种模式之间切换代理；登录名和密码保持不变。

执行 buy_proxy 后，请等待约 5 秒再发送第一个请求。国家筛选设置需要一些时间才能向上游传播，立即发送的第一个请求可能会从其他国家／地区出口。

---

身份验证

• 账户 API 密钥格式为 pc_live_...，发送时使用 Authorization: Bearer pc_live_...。
• create_account 会签发密钥。三个无需身份验证的工具专为 Agent 的初始化流程而设：查询价格、查询国家／地区、创建账户——之后由人类将密钥保存到连接器配置中。
• MCP 服务本身不保存任何状态。它会将你的 Authorization 标头转发到 ProxyCove REST API，并返回 JSON 响应。
• 不带密钥调用需要身份验证的工具时，会返回结构化的 no_api_key 错误，说明该如何处理，而不会崩溃。
• OAuth 2.1 + PKCE 即将推出，届时支持该功能的客户端将无需手动设置标头。Bearer 密钥仍可继续使用。

---

付款：Agent 绝不会接触银行卡数据

这是由工具设计强制保证的严格边界：

• create_topup 会返回一个 payment_url。Agent 只能获取到这个链接。
• Agent 会将链接交给人类，由人类在自己的浏览器中打开并完成付款。
• 付款方式：sbp（俄罗斯即时银行转账）、card_ru、card_international、crypto、crypto_cryptomus。最低充值金额为 $1.50。
• 没有任何工具会接收银行卡号、CVV 或任何付款凭据。整个架构中都没有此类字段。
• 随后，Agent 会轮询 get_payment_status，直到状态变为 paid，然后继续操作。

购买操作（buy_proxy、extend_proxy）只会使用预付余额。Agent 不能花费人类尚未存入的资金。

---

自托管／本地运行

该服务是对外公开的 ProxyCove REST API 的轻量、无状态封装——代码约 200 行 Node，不使用数据库、缓存或持久化。你可以自行托管，以便审查流量、固定版本，或在自己的网络内运行。

**要求：**Node 20+（或 Docker）。

git clone https://github.com/proxycove/mcp-server.git
cd mcp-server
npm install

export BACKEND_BASE_URL=https://proxycove.com
export MCP_PORT=4010
export MCP_SECRET_PATH=/mcp

npm start
# → http://localhost:4010/mcp

Docker：

docker build -t proxycove-mcp .
docker run -d --name proxycove-mcp \
  -p 4010:4010 \
  -e BACKEND_BASE_URL=https://proxycove.com \
  -e MCP_PORT=4010 \
  -e MCP_SECRET_PATH=/mcp \
  proxycove-mcp

环境变量

变量	默认值	用途
MCP_PORT	4010	HTTP 服务监听的端口
MCP_SECRET_PATH	/mcp	MCP 端点挂载的路径
BACKEND_BASE_URL	http://backend:5000	ProxyCove API 的基础 URL；自托管时请使用 https://proxycove.com
PUBLIC_API_INVITE_CODE	(空)	由 create_account 转发的可选邀请码

配置完全通过环境变量提供——没有配置文件，也没有内置在镜像中的密钥。

GET /healthz 返回 { "ok": true, "service": "proxycove-mcp" }。

以相同方式将客户端指向你自己的实例：

{
  "mcpServers": {
    "proxycove": {
      "type": "http",
      "url": "http://localhost:4010/mcp",
      "headers": { "Authorization": "Bearer pc_live_YOUR_KEY" }
    }
  }
}

---

REST API（非 MCP 集成）

MCP 服务执行的所有操作都可以直接通过 HTTP 使用——端点相同，密钥相同：

• 基础 URL：https://proxycove.com/api/v1
• OpenAPI 规范：https://proxycove.com/api/v1/openapi.json

curl https://proxycove.com/api/v1/pricing

curl https://proxycove.com/api/v1/account \
  -H "Authorization: Bearer pc_live_YOUR_KEY"

如果你正在编写常规客户端、LangChain/LlamaIndex 工具、CI 任务或任何非 MCP 主机的程序，请使用此方式。

---

安全

• API 密钥只会显示一次，即在调用 create_account 时。请立即保存——ProxyCove 无法再次显示该密钥。
• 可以随时从 proxycove.com 上的账户撤销密钥，也可以联系支持团队撤销。撤销后会立即终止 Agent 的访问权限；余额和代理仍会保留。
• 尽早运行 attach_recovery 或 link_telegram。如果账户没有恢复渠道，密钥丢失就意味着余额也会丢失。
• 将 pc_live_... 视同密码：它是用于消费的凭证。切勿将其粘贴到共享聊天、公开代码仓库或此跟踪器的问题中。
• 优先使用环境变量间接引用（bearer_token_env_var、${VAR} 替换），而不要在会提交到代码仓库的配置文件中写入明文密钥。
• 如果发现漏洞，或发现某些情况会让 Agent 的消费金额超出预期，请发送邮件至 [email protected]——请勿公开提交安全问题。

---

贡献

欢迎提交问题和拉取请求，尤其是错误报告、上文未涵盖的 MCP 主机客户端配置示例，以及工具描述改进。工具架构是这里面向用户的核心产品界面；如果某段描述误导了你的 Agent，这是值得提交的问题。

许可证

MIT © ProxyCove

---

网站： proxycove.com · MCP 端点： https://mcp.proxycove.com/mcp · REST API： https://proxycove.com/api/v1 · 支持： [email protected]