内容
# ParalonCloud 租赁 — MCP 服务器
在您的 AI 代理中租赁 GPU。这是一个 [MCP](https://modelcontextprotocol.io) 服务器，用于 [ParalonCloud 租赁 API](https://paraloncloud.com/docs/rental-api)：它允许 Claude Code、Claude Desktop、Cursor 或任何 MCP 客户端浏览 GPU、启动租赁、获取连接 URL 并停止它 — 使用自然语言。
> 一个密钥用于所有功能：相同的 `prlc_` 密钥为 ParalonCloud 的 [OpenAI 兼容推理 API](https://paraloncloud.com/docs/inference-api) 提供支持。构建一个调用模型 **和** 租赁 GPU 以运行繁重任务的代理。
## 工具列表
| 工具 | 功能 | 费用 |
| --- | --- | --- |
| `list_gpus` | 列出可租赁的 GPU，包含价格、显存、计算能力、国家 | 免费 |
| `get_balance` | 查询您的信用余额 | 免费 |
| `create_rental` | 启动 Jupyter 租赁（异步 → 轮询） | **消耗积分** |
| `get_rental` | 状态 + 连接 URL（租赁启动后） | 免费 |
| `list_rentals` | 查询您的活跃租赁（`status: "all"` 表示历史记录） | 免费 |
| `destroy_rental` | 停止租赁并停止计费 | — |
## 设置
### 1. 获取具有租赁范围的密钥
1. 在 [控制台](https://paraloncloud.com/console) 中创建 API 密钥。
2. 为该密钥启用 **GPU 租赁** 范围（租赁需手动开启）。
3. 可选：设置 **最大同时运行的租赁** 作为安全上限。
请为代理使用 **专用密钥**，而不是生产密钥。
### 2. 添加到您的 MCP 客户端
客户端通过 `PARALON_API_KEY` 环境变量传递您的密钥 — 您无需编辑服务器。
**Claude Desktop** — `claude_desktop_config.json`:
```json
{
"mcpServers": {
"paraloncloud-rentals": {
"command": "npx",
"args": ["-y", "@paraloncloud/mcp-rentals"],
"env": {
"PARALON_API_KEY": "prlc_your_key_here"
}
}
}
}
```
**Claude Code** — 一条命令：
```bash
claude mcp add paraloncloud-rentals \
--env PARALON_API_KEY=prlc_your_key_here \
-- npx -y @paraloncloud/mcp-rentals
```
**Cursor** — `.cursor/mcp.json`（与 Claude Desktop 相同）。
可选环境变量：`PARALON_BASE_URL`（默认为 `https://paraloncloud.com/api/v1`）。
### 3. 测试
> "列出我可以租赁的最便宜的 GPU，然后在其中一个 GPU 上启动一个 2 小时的 Jupyter 租赁，显存至少为 24GB。"
代理调用 `list_gpus`，选择一个节点，然后调用 `create_rental`（`hours: 2`）。然后，它轮询 `get_rental` 以获取 Jupyter URL。说“停止它”，它会调用 `destroy_rental`。
## 安全
- `create_rental` 和 `destroy_rental` 会影响您的计费 — 您的 MCP 客户端将要求您批准它们（Claude Code/Desktop 默认确认工具调用）。请保持此设置。
- `create_rental` 自动生成一个幂等键，因此重试调用永远不会启动第二个 GPU。
- 传递 `hours` 以便租赁自动停止，即使代理忘记。
- 密钥的 `max_active_rentals` 限制（在控制台中设置）无论如何都限制并发。
## 本地运行（开发）
```bash
PARALON_API_KEY=prlc_your_key_here node server.js
```
## 链接
- 租赁 API 文档：https://paraloncloud.com/docs/rental-api
- 控制台（创建密钥）：https://paraloncloud.com/console
- 推理 API：https://paraloncloud.com/docs/inference-api
MIT
