سرور MCP در EQVPS 16 ابزار را در اختیار میگذارد که به یک ایجنت هوش مصنوعی اجازه میدهد پلنها را کشف کند، یک حساب باز کند، با رمزارز پرداخت کند و یک VPS را بهطور کامل اداره کند. اندپوینت: https://mcp.eqvps.com/mcp (Streamable HTTP). برای وصلکردن آن به کلاینت خود، راهنمای اتصال را ببینید.
مدل احراز هویت: list_plans، register_account و login عمومی هستند. هر ابزار دیگری به یک توکن Bearer نیاز دارد — یکی را فوراً از register_account بگیرید و آن را بهصورت Authorization: Bearer <token> ارسال کنید.
کشف و احراز هویت
| ابزار | احراز هویت | پارامترها | چه کاری انجام میدهد |
|---|---|---|---|
list_plans | عمومی | — | فهرست همه پلنهای VPS: قیمتگذاری، مشخصات و ایمیجهای سیستمعاملی که هر پلن میتواند بوت کند. این را اول فراخوانی کنید تا یک اسلاگ product و یک os_id انتخاب کنید. |
register_account | عمومی | first_name, last_name, email | یک حساب بدون رمز عبور و بدون مرحله انسانی بسازید. یک توکن Bearer به نام token برمیگرداند. |
login | عمومی | email, password | با ایمیل + رمز عبور وارد شوید؛ یک توکن Bearer به نام token برمیگرداند. |
whoami | Bearer | — | پروفایل حساب احراز هویتشده را برمیگرداند (id، نام، ایمیل). توکن را اعتبارسنجی میکند. |
موجودی و سفارشدهی
| ابزار | احراز هویت | پارامترها | چه کاری انجام میدهد |
|---|---|---|---|
get_balance | Bearer | — | موجودی اعتبار پیشپرداخت و واحد پول را برمیگرداند. order_vps بهطور خودکار از آن خرج میکند. |
topup_balance | Bearer | amount (دلار، مثبت) | یک فاکتور شارژ میسازد؛ یک checkout_url از PayRam برمیگرداند. موجودی پس از تأیید پرداخت آنچین USDC/USDT شارژ میشود. هر بار فقط یک شارژ پرداختنشده. |
order_vps | Bearer | product (اسلاگ پلن)، os_id (int)، hostname?، ssh_key? | یک VPS سفارش دهید. یک ssh_key (کلید عمومی) برای ورود root مبتنی بر کلید ارسال کنید. در صورت کافیبودن موجودی از آن پرداخت میکند، در غیر این صورت یک فاکتور برای پرداخت برمیگرداند. |
pay_invoice | Bearer | invoice_id (int) | پرداخت یک فاکتور پرداختنشده متعلق به شما را آغاز میکند. یک checkout_url از PayRam برمیگرداند؛ VPS پس از تأیید پرداخت بهطور خودکار تحویل میشود. |
اداره یک VPS
| ابزار | احراز هویت | پارامترها | چه کاری انجام میدهد |
|---|---|---|---|
list_vps | Bearer | — | فهرست سرویسهای VPS حساب (id، وضعیت، پلن). از id بهعنوان service_id در ادامه استفاده کنید. |
get_vps_status | Bearer | service_id (int) | جزئیات کامل: وضعیت، مشخصات، وضعیت/آپتایم زنده VM، و دسترسی SSH (host، پورت، command آماده برای چسباندن). در اولین فراخوانی برای یک سرور بدون کلید، رمز عبور یکبارمصرف password مربوط به root را برمیگرداند. پس از order_vps تا رسیدن به active پیدرپی فراخوانی کنید. |
power_vps | Bearer | service_id، action = start | stop | reboot | کنترل روشن/خاموش VPS. |
set_hostname | Bearer | service_id، hostname | تنظیم hostname مربوط به VPS (یک برچسب DNS معتبر؛ در ریبوت/بازسازی بعدی اعمال میشود). |
get_vps_metrics | Bearer | service_id، timeframe? = hour | day | week | month | متریکهای سریزمانی CPU، حافظه، شبکه و دیسک (پیشفرض hour). |
مخرب — نیازمند confirm
اینها داده یا دسترسی را پاک میکنند. confirm باید برابر hostname دقیق (از get_vps_status) یا عبارت تحتاللفظی DELETE باشد. ابتدا با انسان تأیید کنید.
| ابزار | احراز هویت | پارامترها | چه کاری انجام میدهد |
|---|---|---|---|
reset_password | Bearer | service_id، confirm | چرخش رمز عبور root. رمز عبور قدیمی بلافاصله از کار میافتد. رمز عبور جدید یکبار از طریق get_vps_status خوانده میشود (به ایمیل هم ارسال میشود). |
reinstall_vps | Bearer | service_id، os_id (int)، confirm | با ایمیج سیستمعامل دادهشده پاک و نصب مجدد میکند — همه دادهها از بین میروند. تحویل ناهمگام است؛ get_vps_status را پیدرپی فراخوانی کنید. |
cancel_service | Bearer | service_id، type? = end_of_period | immediate، confirm? | پیشفرض end_of_period: تا پایان دوره پرداختشده فعال میماند، سپس تمدید نمیشود — بدون از دست رفتن داده. immediate هماکنون VM و همه دادهها را نابود میکند (نیازمند confirm = hostname)؛ زمان پرداختشده استفادهنشده به موجودی شما بازپرداخت میشود (refund_amount). |
مثال: سفارش و بوت یک VPS
list_plans() // pick product "nano", note an os_id
register_account({ first_name, last_name, email }) // → Bearer token
topup_balance({ amount: 10 }) // pay the returned checkout_url in USDC/USDT
order_vps({ product: "nano", os_id: <os_id from list_plans>, ssh_key: "ssh-ed25519 AAAA..." })
get_vps_status({ service_id: <your-service-id> }) // poll → active, read SSH host/port/command
power_vps({ service_id: <your-service-id>, action: "reboot" })
نکاتی برای ایجنتها
- در هر فراخوانی غیرعمومی،
Authorization: Bearer <token>را ارسال کنید. - با USDC/USDT پرداخت کنید (Base، Ethereum، Polygon) — بدون نیاز به کارت. یک موجودی پیشپرداخت را ترجیح دهید تا سفارشدهی یک فراخوانی باشد.
- همیشه
get_vps_statusرا برای خواندن جزئیات دسترسی فراخوانی کنید؛reinstall_vps،reset_passwordوcancel_serviceفوری را برگشتناپذیر در نظر بگیرید.
تازهکار در راهاندازی هستید؟ با راهنمای اتصال شروع کنید، یا مستندات را برای API REST زیربنایی بخوانید.
نظرات
هنوز نظری نیست. اولین نفر باشید.