EQVPS MCP 服务器（1.9.1 版）为客户令牌提供 47 个工具。本页介绍其中用于租用和运行 VPS 的 23 个：每个参数、类型和默认值，最后附一段可复制的调用序列。Endpoint：https://mcp.eqvps.com/mcp（Streamable HTTP）。第一次接触？请先看连接指南。
最后核实：2026-10-20，MCP 服务器 1.9.1（tools/list）。
你需要哪个页面？ VPS 调用参数在本页。所有工具的一览，包括委托、支持、沙箱和 30 个经销商工具，见完整列表。令牌泄露会带来什么后果、如何限制智能体，见 MCP guardrails。
鉴权。 list_plans、get_order_limits、register_account 和 login 是公开的。其他所有工具都需要 Authorization: Bearer <token>。在同一个 MCP 会话中，register_account 或 login 之后令牌会被自动记住。
service_id 是 order_vps 或 list_vps 返回的服务代码，例如 68J67T5。数字 id 也可以用。
账户与令牌
| 工具 | 鉴权 | 参数 | 作用 |
|---|---|---|---|
list_plans | public | — | 列出套餐的价格、配置以及每个套餐可启动的系统镜像。plans[] 包含月付和年付的 plan_id。最先调用。 |
register_account | public | first_name, last_name, email, token_ttl_days? (1–1825, 默认 365) | 创建一个无密码账户，返回可重复使用的 Bearer token 和 token_expires_at。只调用一次：第二次调用会再建一个空账户。 |
login | public | email, password, token_ttl_days? | 返回新令牌。只有在 set_password 之后才可用。 |
refresh_token | Bearer | expires_in_days? (1–1825) | 签发新令牌并立即作废当前令牌。已过期的令牌无法刷新。 |
set_password | Bearer | password (至少 8 个字符，含字母和数字) | 开启邮箱加密码的 login，作为令牌丢失时的备用方式。只能设置一次；再次调用返回 409。 |
whoami | Bearer | — | 账户 id、名称和邮箱。可用来检查令牌。 |
余额与下单
| 工具 | 鉴权 | 参数 | 作用 |
|---|---|---|---|
get_balance | Bearer | — | 预付余额及币种。order_vps 从这里扣款。 |
topup_balance | Bearer | amount (USD) | 创建一笔加密货币充值并返回 checkout_url。链上确认后余额到账。同一时间只能有一笔未付的充值。 |
order_vps | Bearer | product, os_id, hostname?, ssh_key?, period? (month | year), plan_id?, location? (de | fi), quantity? (1–50), addons? (backups | extra_ipv4), idempotency_key? | 下单购买 VPS，余额足够时直接从余额扣款，否则返回账单。不传 location 时由我们选择。Windows 套餐会忽略 ssh_key。quantity 为 2–50 时，只生成一张账单，并创建相应数量的独立服务器；重试时请发送相同的 idempotency_key。 |
get_order_limits | public | product, period?, plan_id?, location?, addons? | 每单上限（max_quantity = 50，防止误输入）以及可用的附加服务和价格。 |
pay_invoice | Bearer | invoice_id | 为未付账单返回 checkout_url。付款后创建 VPS。 |
运维 VPS
| 工具 | 鉴权 | 参数 | 作用 |
|---|---|---|---|
list_vps | Bearer | — | 活跃、创建中和已暂停的服务。已删除的不会列出。 |
get_vps_status | Bearer | service_id | 状态、配置、实时运行状态和访问信息：主机、端口和现成的 command（Linux 用 SSH，Windows 用 RDP）。reveal_password 在启动后返回一次性的 root 密码；password_pending: true 表示 30–60 秒后再调用。 |
reveal_password | Bearer | service_id | 未设置 SSH 密钥的 VPS 的 root 密码，只显示一次。服务器启动期间返回 password_pending: true，请在 30–60 秒后再调用。 |
power_vps | Bearer | service_id, action (start | stop | reboot) | 电源控制。 |
set_hostname | Bearer | service_id, hostname | 通过 guest agent 在运行中的服务器内生效。Windows 需要重启后才生效（reboot_required: true）。服务器关机时返回 409 agent_unavailable。 |
get_vps_metrics | Bearer | service_id, timeframe? (hour | day | week | month, 默认 hour) | CPU、内存、网络和磁盘的时间序列。 |
更换套餐与取消
| 工具 | 鉴权 | 参数 | 作用 |
|---|---|---|---|
get_upgrade_options | Bearer | service_id | 此 VPS 可在保留数据的情况下切换到的套餐：更大的套餐、NAT 转独立 IPv4，或独立 IP 转 NAT。每个选项都会显示 prorated_topup、mode 和 capacity_now。磁盘不能缩小。 |
change_plan | Bearer | service_id, target_plan (product_id), confirm: true | 就地更换套餐，期间重启一次，约一分钟。按比例的差价从余额扣除（余额不足返回 402）。 |
cancel_service | Bearer | service_id, reason (3–500 个字符，必填), type? (end_of_period | immediate), confirm? | 默认 end_of_period：服务器运行到已付周期结束，不再续费。immediate 立即销毁服务器，需要 confirm 填写准确的 hostname；响应中包含 refund_amount 字段。 |
undo_cancel | Bearer | service_id | 撤销已安排的 end_of_period 取消。立即取消无法撤销。 |
破坏性操作：需要 confirm
confirm 填写 get_vps_status 返回的准确 hostname，或 DELETE。调用前先征得人的同意。
| 工具 | 鉴权 | 参数 | 作用 |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | 新的 root 密码在 10–30 秒内送达运行中的服务器，旧密码随即失效。用 reveal_password读取一次新密码。仅用于密码丢失，不要用于仍在启动的服务器。 |
reinstall_vps | Bearer | service_id, os_id, confirm | 清空磁盘并安装 os_id。所有数据丢失。在后台执行；请轮询 get_vps_status。 |
示例：从零到一台运行中的服务器
list_plans() // pick a product slug and an os_id
register_account({ first_name: "Ada", last_name: "Agent", email: "you@yourdomain.com" }) // returns a token
topup_balance({ amount: 10 }) // pay the checkout_url in crypto
order_vps({ product: "nano", os_id: <os_id>, ssh_key: "ssh-ed25519 AAAA..." }) // returns a service_id
get_vps_status({ service_id: "<service_id>" }) // poll until active, then read access.command
power_vps({ service_id: "<service_id>", action: "reboot" })
cancel_service({ service_id: "<service_id>", reason: "project finished" }) // end_of_period; undo_cancel keeps it
给智能体的提示
- 除三个公开工具外，每次调用都要带上
Authorization: Bearer <token>。使用纯 HTTP 时，请把令牌保存到文件：shell 变量在不同命令之间不会保留。 - 从
get_vps_status读取访问信息，不要猜端口。NAT 套餐使用专属端口；独立 IPv4 套餐 Linux 用 22，Windows 用 3389。 - 新服务器启动大约需要一分钟。继续轮询
get_vps_status；不要因为 SSH 没有立刻响应就调用reset_password。 topup_balance和pay_invoice返回支付链接，需要由人或钱包完成付款。门罗币是控制台里单独的人工充值：见用门罗币付款。
不通过 MCP 完成同样操作，请看 REST API 文档。
评论
暂无评论。来做第一个吧。