لدى خادم MCP من EQVPS (الإصدار 1.9.1) 47 أداة لرمز العميل. تتناول هذه الصفحة 23 منها تستأجر VPS وتديره: كل معامل ونوعه وقيمته الافتراضية، وفي النهاية سلسلة استدعاءات يمكنك نسخها. 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) | تنشئ حسابًا بلا كلمة مرور وتعيد token من نوع Bearer قابلًا لإعادة الاستخدام مع 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 جاهز (SSH لـLinux وRDP لـWindows). تعيد reveal_password كلمة مرور root لمرة واحدة بعد الإقلاع؛ وpassword_pending: true تعني أعد الاستدعاء بعد 30–60 ثانية. |
reveal_password | Bearer | service_id | كلمة مرور root لخادم VPS بلا مفتاح SSH، تظهر مرة واحدة. أثناء إقلاع الخادم: password_pending: true، استدعِ مجددًا بعد 30–60 ثانية. |
power_vps | Bearer | service_id, action (start | stop | reboot) | التحكم في التشغيل. |
set_hostname | Bearer | service_id, hostname | يُطبَّق داخل الخادم العامل عبر وكيل الضيف. في Windows يسري بعد إعادة التشغيل (reboot_required: true). إذا كان الخادم مطفأً تعيد 409 agent_unavailable. |
get_vps_metrics | Bearer | service_id, timeframe? (hour | day | week | month, افتراضيًا hour) | المعالج والذاكرة والشبكة والقرص عبر الزمن. |
تغيير الخطة والإلغاء
| الأداة | المصادقة | المعاملات | ماذا تفعل |
|---|---|---|---|
get_upgrade_options | Bearer | service_id | الخطط التي يمكن لهذا الخادم الانتقال إليها مع الاحتفاظ ببياناته: خطة أكبر، أو من NAT إلى IPv4 مخصص، أو من المخصص إلى 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 هو hostname الدقيق من get_vps_status، أو 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 العادي احفظ الرمز في ملف: متغير الصدفة لا يبقى بين أوامر منفصلة. - اقرأ بيانات الوصول من
get_vps_statusبدل تخمين المنفذ. خطط NAT تستخدم منفذًا شخصيًا؛ وخطط IPv4 المخصص تستخدم 22 لـLinux و3389 لـWindows. - يحتاج الخادم الجديد نحو دقيقة ليُقلع. واصل متابعة
get_vps_status؛ ولا تستدعِreset_passwordلمجرد أن SSH لم يردّ فورًا. - تعيد
topup_balanceوpay_invoiceرابط دفع، ويجب أن يدفعه إنسان أو محفظة. Monero شحن يدوي منفصل في لوحة التحكم: راجع الدفع بعملة Monero.
الإجراءات نفسها من دون MCP موجودة في توثيق REST API.
التعليقات
لا تعليقات بعد. كن الأول.