2extract

2extract MCP 服务

适用于 2extract 的远程 Model Context Protocol 服务。它可让 AI Agent 创建和管理住宅及移动代理，选择精确到城市、ZIP 或运营商的地理定位，设置流量和支出限额，并报告用量和费用。

这是一个托管服务。无需在本地安装或运行任何内容：MCP 客户端使用你的 2extract API 密钥连接到下方 URL。

端点	https://mcp.2extract.com/mcp
传输方式	Streamable HTTP
身份验证	Authorization: Bearer 2xt_...（2extract API 密钥）

获取 API 密钥

1. 在 2extract 注册或登录。
2. 打开 API 密钥并创建密钥。
3. 授予 Agent 所需的权限范围：proxies:read、proxies:write、balance:read、stats:read、geo:read。写入权限范围不包含读取权限，因此大多数工作流需要同时具备 proxies:read 和 proxies:write。

只读密钥（不含 proxies:write）足以用于报告和查询。

连接

Claude Code

claude mcp add --transport http 2extract https://mcp.2extract.com/mcp \
  --header "Authorization: Bearer 2xt_your_api_key"

Codex CLI

密钥从 EXTRACT_API_KEY 环境变量中读取；Codex 会自行添加 Bearer：

export EXTRACT_API_KEY=2xt_your_api_key
codex mcp add 2extract --url https://mcp.2extract.com/mcp --bearer-token-env-var EXTRACT_API_KEY

也可以编辑 ~/.codex/config.toml（或可信项目中的 .codex/config.toml）：

[mcp_servers.2extract]
url = "https://mcp.2extract.com/mcp"
bearer_token_env_var = "EXTRACT_API_KEY"

Gemini CLI

gemini mcp add -s user --transport http \
  --header "Authorization: Bearer 2xt_your_api_key" \
  2extract https://mcp.2extract.com/mcp

也可以编辑 ~/.gemini/settings.json（或项目中的 .gemini/settings.json）：

{
  "mcpServers": {
    "2extract": {
      "httpUrl": "https://mcp.2extract.com/mcp",
      "headers": { "Authorization": "Bearer 2xt_your_api_key" }
    }
  }
}

OpenCode

项目中的 opencode.json（或 ~/.config/opencode/opencode.json）。密钥从 EXTRACT_API_KEY 环境变量中读取：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "2extract": {
      "type": "remote",
      "url": "https://mcp.2extract.com/mcp",
      "enabled": true,
      "headers": { "Authorization": "Bearer {env:EXTRACT_API_KEY}" }
    }
  }
}

Claude Desktop

claude_desktop_config.json：

{
  "mcpServers": {
    "2extract": {
      "type": "http",
      "url": "https://mcp.2extract.com/mcp",
      "headers": { "Authorization": "Bearer 2xt_your_api_key" }
    }
  }
}

Cursor

~/.cursor/mcp.json 或 .cursor/mcp.json：

{
  "mcpServers": {
    "2extract": {
      "url": "https://mcp.2extract.com/mcp",
      "headers": { "Authorization": "Bearer 2xt_your_api_key" }
    }
  }
}

VS Code

.vscode/mcp.json（首次使用时会提示输入密钥，且不会将其存储在文件中）：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "2extract-api-key",
      "description": "2extract API key",
      "password": true
    }
  ],
  "servers": {
    "2extract": {
      "type": "http",
      "url": "https://mcp.2extract.com/mcp",
      "headers": { "Authorization": "Bearer ${input:2extract-api-key}" }
    }
  }
}

Cline

打开 Cline 面板，点击 MCP Servers，再点击 Configure MCP Servers，然后添加到 cline_mcp_settings.json：

{
  "mcpServers": {
    "2extract": {
      "type": "streamableHttp",
      "url": "https://mcp.2extract.com/mcp",
      "headers": { "Authorization": "Bearer 2xt_your_api_key" },
      "disabled": false
    }
  }
}

保留 "type": "streamableHttp"：否则 Cline 会回退到较旧的 SSE 传输方式。

其他客户端

任何支持远程 MCP 服务的客户端均可使用。提供端点 URL、Streamable HTTP 传输方式和 Authorization 标头即可。

工具

账户

工具	功能	权限范围
getAccountBalance	可用资金、是否可以创建新代理，以及代理用户名的前缀	balance:read
getAccountTrafficUsage	某个时段内账户或单个代理的流量和支出	stats:read
listAccountBalanceHistory	某个时段内的充值和扣费记录	stats:read

地理定位

工具	功能	权限范围
listGeoCountries	可用于定位的国家	geo:read
searchGeoRegions	某个国家内的地区和州	geo:read
searchGeoCities	某个国家或地区内的城市	geo:read
searchGeoZips	某个国家内的 ZIP 和邮政编码	geo:read
searchGeoISP	用于 ISP 定位的移动运营商	geo:read

套餐

工具	功能	权限范围
listProxyPlans	可用套餐及其价格	proxies:read

代理

工具	功能	范围
listProxyResources	列出账户中的所有代理及其流量和费用	proxies:read
getProxyResource	查看单个代理的完整详情	proxies:read
createProxyResource	创建代理（会产生费用）	proxies:write
updateProxyResource	更改描述、状态、地理位置、白名单或限制	proxies:write
deactivateProxyResource	停止流量，但不删除代理	proxies:write
deleteProxyResource	永久删除代理（会请求确认）	proxies:write
regenerateProxyPassword	生成新密码（会请求确认）	proxies:write
setProxyLimits	设置每日或每月流量或费用上限	proxies:write
setProxyIpWhitelist	限制可以使用代理的 IP 地址	proxies:write
setProxyTargetHosts	限制代理可以访问的域名（支持 *.example.com 这类通配符）	proxies:write

破坏性工具的确认操作由你的客户端处理。如果客户端不请求确认，任何拥有 proxies:write 权限的密钥都可以执行这些操作，因此请妥善设置密钥权限范围。

提示词

提示词	参数	功能
create-proxy-resource	purpose、proxy_type?、country?	根据指定用途创建代理，并返回连接字符串
build-connection-string	proxy_id?、purpose?	为现有代理生成连接字符串
monthly-cost-report	period	按代理列出指定时段的流量和费用，并标记异常值。只读
cleanup-unused-proxies	无	查找 30 天内没有流量的代理，并在你确认后将其停用。不会删除代理

请求示例

• “创建一个位于德国柏林的住宅代理，用于价格监控，每月流量上限为 5 GB。”
• “为我的 serp_us 代理生成一个粘性会话连接字符串。”
• “上个月每个代理的流量费用是多少？”
• “哪些代理在过去 30 天内没有流量？停用它们。”
• “查找我可以指定的美国移动运营商。”

文档

• MCP 服务概览
• 快速入门
• 工具参考
• 提示词
• 使用示例
• 常见问题
• 连接页面

支持

• 电子邮件：[email protected]
• 关于此项目条目的问题：在此仓库中提交 issue

法律信息

• 服务条款
• 隐私政策

服务端源代码未公开。此仓库包含公开项目条目、客户端配置示例和注册表清单（server.json）。