内容
<div align="center">
<img src="https://imagedelivery.net/r4caA8hJ3Ww3j8uyC_NNCA/95a9137a-43fd-48d4-7243-983f3f4a3d00/public" alt="Proxidize" height="60" />
<h1>Proxidize MCP 服务器</h1>
<p>
<strong>通过任何 AI 代理管理您的移动和住宅代理。</strong><br/>
旋转 IP 地址，切换位置，监控使用情况，标记代理以及控制访问 — 所有操作都可以通过自然语言完成。
</p>
<p>
<a href="https://www.npmjs.com/package/@proxidize/mcp">
<img src="https://img.shields.io/npm/v/@proxidize/mcp?style=for-the-badge&color=blue" alt="npm 版本"/>
</a>
<a href="LICENSE">
<img src="https://img.shields.io/badge/license-MIT-purple?style=for-the-badge" alt="许可证"/>
</a>
</p>
<p>
<a href="#快速入门">快速入门</a> •
<a href="#可用工具">工具</a> •
<a href="#配置">配置</a> •
<a href="#支持的客户端">客户端</a>
</p>
</div>
---
## 概述
Proxidize MCP 服务器，用于 [Proxidize](https://proxidize.com) API。 为 Claude、Cursor 等 MCP 客户端提供直接访问您的代理基础设施 — 无需仪表盘切换选项卡。
启动时，它会检查您的账户上哪些 Proxidize 订阅是活跃的，并仅注册相关的工具。每个代理计划都会获得代理管理工具，每个 GB 计划都会获得使用情况和访问点工具，依此类推。
---
## 快速入门
需要 [Node.js](https://nodejs.org) 18 或更高版本。
### Claude 代码
```bash
# 本地（默认）— 当前项目，私有
claude mcp add proxidize -e PROXIDIZE_API_TOKEN=您的_API_TOKEN -- npx -y @proxidize/mcp
# 用户 — 您的所有项目，私有
claude mcp add proxidize --scope user -e PROXIDIZE_API_TOKEN=您的_API_TOKEN -- npx -y @proxidize/mcp
# 项目 — 通过 .mcp.json 与团队共享（使用 ${VAR} 扩展名以将令牌排除在版本控制之外）
claude mcp add --scope project proxidize -- npx -y @proxidize/mcp
```
在 Claude Code 中运行 `/mcp` 以验证连接。
### Claude 桌面版
添加到 `claude_desktop_config.json`:
```json
{
"mcpServers": {
"proxidize": {
"command": "npx",
"args": ["-y", "@proxidize/mcp"],
"env": {
"PROXIDIZE_API_TOKEN": "您的_API_TOKEN"
}
}
}
}
```
### Cursor / Windsurf / VS Code
添加到 `.mcp.json` 或您的 IDE 的 MCP 配置中:
```json
{
"mcpServers": {
"proxidize": {
"command": "npx",
"args": ["-y", "@proxidize/mcp"],
"env": {
"PROXIDIZE_API_TOKEN": "您的_API_TOKEN"
}
}
}
}
```
### 获取您的 API 令牌
1. 登录到 [Proxidize 仪表盘](https://app.proxidize.com)
2. 点击头像下拉菜单 → **设置**
3. 复制您的 API 令牌
---
## 可用工具
### 账户
| 工具 | 描述 |
|------|-------------|
| `get_subscription` | 列出活跃的订阅，可选过滤到一个计划类型 |
| `get_outbound_ip` | 获取运行此 MCP 服务器的机器的公共 IP 地址（用于 IP 白名单） |
### 每代理（专用移动代理）
| 工具 | 描述 |
|------|-------------|
| `list_proxies` | 列出所有代理及其 IP 地址、即用连接 URL、速度、使用情况和标签 |
| `get_proxy` | 通过会话 ID 获取单个代理的详细信息 |
| `rotate_proxy` | 旋转代理的 IP 地址并获取旧 IP 地址和新 IP 地址，可选锁定到城市或运营商 |
| `rotate_proxy_url` | 使用其旋转令牌旋转代理 |
| `set_rotation_interval` | 设置自动旋转（60 秒至 7 天）或禁用（-1） |
| `update_proxy_password` | 更改所有代理的密码 |
| `list_proxy_locations` | 列出可用的美国城市及其平均速度 |
| `list_proxy_carriers` | 列出运营商（T-Mobile、AT&T、Verizon），可按位置过滤 |
| `create_ip_whitelist` | 为代理访问创建 IP 白名单 |
| `list_tags` | 列出所有代理标签 |
| `create_tag` | 创建新标签 |
| `delete_tag` | 删除标签（取消所有代理的分配） |
| `tag_proxy` | 将标签分配给代理会话 |
| `untag_proxy` | 从代理会话中删除标签 |
### 每 GB 移动代理
前缀为 `mobile_`。仅在您拥有有效的每 GB 移动订阅时注册。
| 工具 | 描述 |
|------|-------------|
| `mobile_get_usage` | 数据余额 — 已使用和可用的字节数 |
| `mobile_list_locations` | 可用的城市及其速度，可按运营商、国家或州过滤 |
| `mobile_list_carriers` | 可用的运营商，可按国家过滤 |
| `mobile_get_settings` | 访问点代理设置 |
| `mobile_list_access_points` | 列出共享您的数据池的子用户 |
| `mobile_create_access_point` | 创建新的子用户 |
| `mobile_create_ip_whitelist` | 创建 IP 白名单，带有位置/运营商/协议选项 |
| `mobile_update_ip_whitelist` | 更新现有的白名单条目 |
| `mobile_update_settings` | 更新访问点路由（城市、运营商、协议） |
### 分析
当至少有一个计划活跃时注册。由 Proxidize 分析服务支持；查询界面可能会演变。
| 工具 | 描述 |
|------|-------------|
| `get_traffic_analytics` | 随时间变化的带宽和请求/失败次数，按代理会话或访问点 |
| `get_top_domains` | 按数据量和请求次数排名的顶级目标域名 |
| `get_connection_history` | 请求日志：URL、方法、状态、持续时间、字节、源 IP、上游地理位置、错误 |
### 每 GB 住宅代理
与移动代理相同，但前缀为 `residential_`。仅在您拥有有效的住宅订阅时注册。
| 工具 | 描述 |
|------|-------------|
| `residential_get_usage` | 住宅数据余额 |
| `residential_list_locations` | 可用的住宅位置，可按运营商、国家或州过滤 |
| `residential_list_carriers` | 可用的住宅运营商，可按国家过滤 |
| `residential_get_settings` | 访问点设置 |
| `residential_list_access_points` | 列出住宅子用户 |
| `residential_create_access_point` | 创建住宅子用户 |
| `residential_create_ip_whitelist` | 为住宅代理创建 IP 白名单 |
| `residential_update_ip_whitelist` | 更新住宅白名单条目 |
| `residential_update_settings` | 更新访问点路由（城市、运营商、协议） |
---
## 配置
### 环境变量
| 变量 | 必需 | 默认值 | 描述 |
|----------|----------|---------|-------------|
| `PROXIDIZE_API_TOKEN` | 是 | — | 您的 Proxidize API 令牌 |
| `PROXIDIZE_BASE_URL` | 否 | `https://api.proxidize.com/api/v1` | API 基本 URL |
| `PROXIDIZE_PROXY_HOST` | 否 | `pg.proxi.es` | 连接 URL 中使用的代理网关主机 |
| `PROXIDIZE_TIMEOUT` | 否 | `30000` | 请求超时（毫秒） |
| `PROXIDIZE_MAX_RETRIES` | 否 | `2` | 服务器错误时的最大重试次数（0-5） |
| `PROXIDIZE_DISABLE_ANALYTICS` | 否 | — | 设置为 `1` 以禁用匿名使用情况分析（`DO_NOT_TRACK=1` 也有效） |
### 工具发现
启动时，服务器查询订阅 API 以发现您的活跃计划。工具按计划注册：
- **`per_proxy_mobile`** → 14 个代理管理工具
- **`per_gb_mobile`** → 9 个移动工具
- **`per_gb_residential`** → 9 个住宅工具
- **任何活跃计划** → 3 个分析工具
- **始终加载** → `get_subscription`、`get_outbound_ip`
无订阅，无订阅特定工具。不会公开您的账户无法使用的内容。
### 使用情况分析
服务器通过 [PostHog](https://posthog.com) 收集匿名使用情况分析（调用哪些工具、延迟和错误率），以帮助我们改进它。不会发送工具响应，参数中的敏感值会自动编辑。随时可以通过设置 `PROXIDIZE_DISABLE_ANALYTICS=1`（或标准 `DO_NOT_TRACK=1`）退出。
---
## 支持的客户端
与任何 MCP 兼容的客户端配合使用：
- [Claude Code](https://code.claude.com)（CLI、桌面版、网页版）
- [Claude 桌面版](https://claude.ai/download)
- [Cursor](https://cursor.sh)
- [Windsurf](https://windsurf.com)
- [VS Code](https://code.visualstudio.com)（带有 MCP 扩展）
---
## 故障排除
### "PROXIDIZE_API_TOKEN 是必需的"
在您的 MCP 服务器配置中设置环境变量。参见 [快速入门](#快速入门)。
### 服务器连接但仅显示 `get_subscription` 和 `get_outbound_ip`
订阅发现失败或未找到活跃计划。检查您的 API 令牌是否有效（从 Proxidize 仪表盘的设置中重新生成），并检查您的账户是否有活跃的订阅。
### 工具返回 "HTTP 401：无效令牌"
双重检查令牌自您配置服务器以来是否未被重新生成。
### 超时错误
增加超时： 在您的环境配置中将 `PROXIDIZE_TIMEOUT` 设置为 `60000`。
---
## 开发
从源代码运行而不是从 npm 运行：
```bash
git clone https://github.com/proxidize/proxidize-mcp.git
cd proxidize-mcp
npm install
npm run build
```
然后将您的 MCP 客户端指向构建输出 — 例如 `claude mcp add proxidize -e PROXIDIZE_API_TOKEN=您的_API_TOKEN -- node /path/to/proxidize-mcp/dist/index.js`。
使用 `npm test` 运行测试套件（不需要凭证 — 它针对模拟 API 启动服务器）。
---
## 许可证
MIT
