EQVPS MCP 伺服器（1.6.0 版）為客戶權杖提供 45 個工具。本頁介紹其中用於租用和執行 VPS 的 21 個：每個參數、型別和預設值，最後附一段可複製的呼叫序列。Endpoint：https://mcp.eqvps.com/mcp（Streamable HTTP）。第一次接觸？請先看連線指南。
最後核實：2026-10-04，MCP 伺服器 1.6.0（tools/list）。
您需要哪個頁面？ VPS 呼叫參數在本頁。所有工具的一覽，包括委託、支援、沙箱和 30 個經銷商工具，見完整列表。權杖洩露會帶來什麼後果、如何限制代理，見 MCP guardrails。
驗證。 list_plans、register_account 和 login 是公開的。其他所有工具都需要 Authorization: Bearer <token>。在同一個 MCP 工作階段中，register_account 或 login 之後權杖會被自動記住。
service_id 是 order_vps 或 list_vps 傳回的服務程式碼，例如 68J67T5。數字 id 也可以用。
帳戶與權杖
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
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、名稱和電子郵件。可用來檢查權杖。 |
餘額與下單
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
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) | 下單 VPS，餘額足夠時直接扣款，否則返回一張帳單。不傳 location 時由我們選擇。所選地點沒有空餘容量時返回 409 location_unavailable 和 available 列表，不會扣款。Windows 方案會忽略 ssh_key。 |
pay_invoice | Bearer | invoice_id | 為未付帳單返回 checkout_url。付款後建立 VPS。 |
維運 VPS
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
list_vps | Bearer | — | 活躍、建立中和已暫停的服務。已刪除的不會列出。 |
get_vps_status | Bearer | service_id, reveal? | 狀態、設定、即時執行狀態和存取資訊：主機、埠和現成的 command（Linux 用 SSH，Windows 用 RDP）。reveal: true 在啟動後返回一次性的 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、記憶體、網路和磁碟的時間序列。 |
更換方案與取消
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
get_upgrade_options | Bearer | service_id | 這台 VPS 在保留資料的前提下可以切換到的方案：更大的方案、NAT 轉獨立 IPv4，或獨立 IPv4 轉 NAT。每個選項顯示 prorated_topup 和 mode。磁碟不能縮小。 |
change_plan | Bearer | service_id, target_plan (product_id), confirm: true | 原地更換方案，重新啟動一次，約一分鐘。按比例計算的差價從餘額扣除（餘額不足返回 402）；轉為 NAT 會退還差價。 |
cancel_service | Bearer | service_id, reason (3–500 個字元，必填), type? (end_of_period | immediate), confirm? | 預設 end_of_period：伺服器執行到已付週期結束，不再續費。immediate 立即銷毀伺服器，需要 confirm 填寫準確的 hostname，並把未用時長退回餘額。 |
undo_cancel | Bearer | service_id | 撤銷已安排的 end_of_period 取消。立即取消無法撤銷。 |
破壞性操作：需要 confirm
confirm 填寫 get_vps_status 傳回的準確 hostname，或 DELETE。呼叫前先徵得人的同意。
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | 新的 root 密碼在 10–30 秒內送達執行中的伺服器，舊密碼隨即失效。用 get_vps_status（reveal: true）讀取一次新密碼。僅用於密碼遺失，不要用於仍在啟動的伺服器。 |
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 文件。
評論
目前還沒有評論。歡迎成為第一位。