يعرض خادم EQVPS MCP 16 أداة تتيح لوكيل ذكاء اصطناعي اكتشاف الخطط، وفتح حساب، والدفع بالعملات المشفّرة، وتشغيل VPS كليًا. نقطة النهاية: https://mcp.eqvps.com/mcp (Streamable HTTP). راجع دليل الربط لتوصيله بعميلك.
نموذج المصادقة: list_plans وregister_account وlogin عامة. كل أداة أخرى تتطلّب رمز Bearer — احصل على واحد فورًا من register_account وأرسله كـ Authorization: Bearer <token>.
الاكتشاف والمصادقة
| الأداة | المصادقة | المعاملات | ماذا تفعل |
|---|---|---|---|
list_plans | عامة | — | اسرد كل خطط الـ VPS: الأسعار والمواصفات وصور نظام التشغيل التي يستطيع كلٌّ إقلاعها. استدعِها أولًا لاختيار product slug وos_id. |
register_account | عامة | first_name، last_name، email | أنشئ حسابًا بلا كلمة مرور وبلا خطوة بشرية. يُعيد رمز Bearer باسم token. |
login | عامة | email، password | سجّل الدخول ببريد + كلمة مرور؛ يُعيد رمز Bearer. |
whoami | Bearer | — | يُعيد ملف الحساب المُصادَق (id، اسم، بريد). يتحقّق من الرمز. |
الرصيد والطلب
| الأداة | المصادقة | المعاملات | ماذا تفعل |
|---|---|---|---|
get_balance | Bearer | — | يُعيد رصيد الائتمان المدفوع مسبقًا والعملة. order_vps يُنفق منه تلقائيًا. |
topup_balance | Bearer | amount (بالدولار، موجب) | ينشئ فاتورة شحن؛ يُعيد checkout_url من PayRam. يُضاف الرصيد حالما تتأكّد دفعة USDC/USDT على السلسلة. شحنة واحدة غير مدفوعة في المرة. |
order_vps | Bearer | product (slug الخطة)، 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 (المضيف، المنفذ، command جاهز للّصق). عند أوّل استدعاء لخادم بلا مفتاح يُعيد كلمة مرور root لمرة واحدة. استعلم بعد order_vps حتى active. |
power_vps | Bearer | service_id، action = start | stop | reboot | تحكّم بطاقة الـ VPS. |
set_hostname | Bearer | service_id، hostname | اضبط اسم مضيف الـ VPS (تسمية DNS صالحة؛ يُطبّق عند إعادة التشغيل/البناء التالية). |
get_vps_metrics | Bearer | service_id، timeframe? = hour | day | week | month | مقاييس سلاسل زمنية للمعالج والذاكرة والشبكة والقرص (الافتراضي hour). |
مُدمِّرة — تتطلّب confirm
هذه تمحو بيانات أو وصولًا. يجب أن تساوي confirm اسم المضيف الدقيق (من 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 = اسم المضيف)؛ يُردّ الوقت المدفوع غير المستخدم إلى رصيدك (refund_amount). |
مثال: اطلب وأقلِع VPS
list_plans() // اختر product "nano"، لاحظ os_id
register_account({ first_name, last_name, email }) // → رمز Bearer
topup_balance({ amount: 10 }) // ادفع checkout_url المُعاد بـ 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> }) // استعلم → active، اقرأ مضيف/منفذ/command SSH
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 الفوري كإجراءات لا رجعة فيها.
جديد على الإعداد؟ ابدأ بـ دليل الربط، أو اقرأ التوثيق لـ REST API الأساس.
التعليقات
لا تعليقات بعد. كن الأول.