خادم MCP أصلي للذكاء الاصطناعي

خادم SMSBulk MCP

استخدم SMSBulk مباشرة من Claude Desktop أو Cursor أو أي عميل متوافق مع MCP — اطلب أرقام SMS وعناوين بريد إلكتروني مؤقتة واقرأ الرموز.

يتيح بروتوكول سياق النموذج (MCP) لمساعدي الذكاء الاصطناعي استدعاء أدوات خارجية. يربط هذا الخادم مفتوح المصدر واجهة برمجة تطبيقات SMSBulk بعميل الذكاء الاصطناعي لديك، دون منطق أعمال ودون تخزين أي أسرار.

مفتوح المصدر على GitHub

ماذا يفعل

الخادم عبارة عن مُرحِّل خالص: يعيد توجيه كل طلب إلى واجهة SMSBulk العامة باستخدام مفتاح API الخاص بك. يوفر 18 أداة موزعة على أربع مجموعات — الكتالوج وSMS والمحفظة والبريد الإلكتروني.

على عكس المزوّدين الذين يقدمون SMS فقط، يوفر SMSBulk التحقق عبر الهاتف والبريد الإلكتروني معًا. أدوات البريد الإلكتروني ليس لها مثيل في معظم خوادم MCP المنافسة.

التثبيت

يتطلب Node.js 18 أو أحدث. استنسخ المستودع وثبّت التبعيات ثم ابنِ المشروع:

git clone https://github.com/Tolunay3434/smsbulk-mcp.git
cd smsbulk-mcp
npm install
npm run build

ثم وجّه عميل MCP لديك إلى dist/index.js المبني. تعمل أدوات الكتالوج دون مفتاح؛ أما بقية الأدوات فتحتاج إلى مفتاح API الخاص بـ SMSBulk.

إعداد العميل

Claude Desktop

{
  "mcpServers": {
    "smsbulk": {
      "command": "node",
      "args": ["/absolute/path/to/smsbulk-mcp/dist/index.js"],
      "env": {
        "SMSBULK_API_KEY": "your_api_key_here",
        "MAX_SPEND_PER_SESSION": "5"
      }
    }
  }
}

أضف هذا إلى claude_desktop_config.json ثم أعد تشغيل Claude Desktop. ستظهر أدوات SMSBulk في قائمة الأدوات.

Cursor

{
  "mcpServers": {
    "smsbulk": {
      "command": "node",
      "args": ["/absolute/path/to/smsbulk-mcp/dist/index.js"],
      "env": {
        "SMSBULK_API_KEY": "your_api_key_here"
      }
    }
  }
}

أضف هذا إلى ~/.cursor/mcp.json (عام) أو .cursor/mcp.json (لكل مشروع).

استبدل /absolute/path/to/smsbulk-mcp بالمسار الحقيقي الذي استنسخت إليه المستودع. لا تنشر مفتاح API الخاص بك أبدًا.

مرجع الأدوات

18 أداة. أدوات الكتالوج لا تحتاج مفتاحًا؛ والبقية ترسل x-api-key الخاص بك.

الكتالوج

لا يتطلب مفتاح API

list_services—

جميع الخدمات النشطة مع ملخص المخزون والحد الأدنى للسعر.

list_countries—

جميع الدول المدعومة مع الأعلام ورموز ISO.

get_serviceslug

خدمة واحدة، يتم البحث عنها بمعرّف SEO أو رمز الخدمة.

get_service_countriesslug

الدول المتوفرة لخدمة ما، مع الأسعار والمخزون ومستويات السرعة.

التحقق عبر SMS

يتطلب مفتاح API

request_numberserviceCode, countryIso, operator?, idempotency_token?يخصم

يحجز رقمًا للتحقق عبر SMS. محمي ضد إعادة المحاولة.

get_statusid

حالة ورمز SMS (بعد استلامه) لعملية تفعيل واحدة.

completeid

يضع علامة على التفعيل كمكتمل. هذا نهائي.

cancelid

يلغي التفعيل؛ ويعيد المبلغ إلى المحفظة إذا لم يصل أي SMS.

request_resendid

يطلب من المزوّد إرسال رسالة SMS أخرى إلى الرقم نفسه.

list_activationslimit?, cursor?, status?

عمليات التفعيل الخاصة بك، مقسّمة بالمؤشر، الأحدث أولًا.

المحفظة

يتطلب مفتاح API

get_balance—

رصيد محفظتك الحالي.

list_transactionslimit?, cursor?

آخر الإيداعات والخصومات والمبالغ المستردة.

التحقق عبر البريد

يتطلب مفتاح APIغير متوفر على خوادم SMS فقط

email_get_domainssite

نطاقات مزوّدي البريد المتاحة لموقع مستهدف، مع الأسعار والمخزون.

email_requestsite, domain, idempotency_token?يخصم

يحجز عنوان بريد إلكتروني مؤقتًا. محمي ضد إعادة المحاولة.

email_listlimit?

آخر عمليات تفعيل البريد لديك، الأحدث أولًا (حتى 100، دون مؤشر).

email_get_statusid

الحالة ورمز OTP المُحلَّل وجسم HTML الخام (بعد استلامه).

email_reorderidيخصم

يعيد فتح العنوان نفسه للحصول على OTP آخر.

email_cancelid

يلغي؛ ويعيد المبلغ إلى المحفظة إذا لم يصل أي OTP.

الأمان والقيود

هذه الحمايات أحزمة أمان للراحة، وليست ضمانات.

حماية إعادة المحاولة بأفضل جهد — وليست توافقية مضمونة

تحتفظ request_number وemail_request بحماية صغيرة في الذاكرة تلتقط الحالة العرضية الشائعة: إذا استُدعيت أداة الطلب نفسها مرتين في الجلسة نفسها بالوسائط نفسها، فإن الاستدعاء الثاني يعيد النتيجة الأولى بدلًا من الخصم مرة أخرى. هذه ليست توافقية مضمونة — فهي تعيش فقط في ذاكرة هذه العملية، وتُعاد إلى الصفر عند إعادة التشغيل، ولا تنسّق بين العملاء، ولا يمكنها منع تعارض حقيقي من جانب الخادم. لإعادة محاولة طلب واحد بأمان، مرّر idempotency_token نفسه؛ ولتقديم طلب ثانٍ عن قصد، مرّر رمزًا مختلفًا.

حد إنفاق مرن (MAX_SPEND_PER_SESSION)

عند ضبطه، يتتبع الخادم التكلفة الفعلية لكل طلب ناجح ويمنع الطلب التالي بمجرد بلوغ الإجمالي حدّك. وهو مرن وفي الذاكرة — يُعاد إلى الصفر عند إعادة التشغيل، ويغطي هذه الجلسة فقط، ويمنع الطلب التالي بدلًا من تقسيم طلب واحد. الطلب المُقدَّم وأنت لا تزال دون الحد يُسمح به حتى لو دفع الإجمالي إلى ما فوق الحد. وهو طبقة إضافية فوق حدود حسابك من جانب الخادم (الرصيد، الحصة اليومية، حدود المعدل).

أدخل التحقق إلى سير عمل الذكاء الاصطناعي لديك

استنسخ الخادم، وأدخل مفتاح API الخاص بك، واطلب رموز SMS أو البريد مباشرة من مساعدك.

عرض على GitHub احصل على مفتاح API وثائق SMS API وثائق البريد API