تخطَّ إلى المحتوى

تثبيت خادم MCP

في الاستخدام المعتاد لا تشغّل الخادم بنفسك: عميل MCP يشغّله عند الحاجة. تشرح هذه الصفحة ما يشغّله العميل والمتغيرات التي يحتاجها. لإضافته إلى عميل، انتقل إلى العملاء.

  • Node.js 20 أو أحدث، مع وجود npx في PATH الخاص بالتطبيق الذي يشغّل الخادم.
  • مفتاح API من SMSFabric. أنشئه من المطورون ← مفاتيح API في البوابة (الشرح خطوة بخطوة) بالنطاقات التي تحتاجها فقط (أيها). ابدأ بمفتاح اختبار (sf_test_…).
المتغير مطلوب القيمة
SMSFABRIC_API_KEY نعم sf_live_… أو sf_test_…. يتوقف الخادم عند البدء إذا غاب.
SMSFABRIC_BASE_URL لا أصل الواجهة البرمجية. الافتراضي https://api.smsfabric.com، والقيمة الفارغة تعامل كأنها غير مضبوطة. اضبطه على http://localhost:3000 لواجهة محلية.

يمرر العميل هذه المتغيرات إلى الخادم من إعداداته، غالبًا في كتلة env.

أبسط إعداد. ينزّل npx الحزمة عند أول استخدام ويخزنها مؤقتًا:

نافذة طرفيّة
SMSFABRIC_API_KEY=sf_test_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx npx -y @smsfabric/mcp-server

الخيار -y يتخطى سؤال التثبيت، الذي لا يستطيع العميل الإجابة عنه. عندما يعمل الخادم يطبع smsfabric-mcp: connected (https://api.smsfabric.com) في stderr وينتظر عميلًا على stdin. أوقفه بـ Ctrl+C.

التثبيت على مستوى النظام يضع الأمر smsfabric-mcp في PATH، فيشغّله العميل دون npx:

نافذة طرفيّة
npm install -g @smsfabric/mcp-server

ثم استخدم smsfabric-mcp أمرًا دون وسائط في إعدادات العميل. حدّثه بالأمر نفسه عند صدور إصدار جديد.

التشغيل من الكود المصدري

Section titled “التشغيل من الكود المصدري”

لتجربة تغيير لم يصدر بعد، ابن الخادم من المستودع:

  1. انسخ المستودع وثبّت اعتمادياته.

    نافذة طرفيّة
    git clone https://github.com/elshahat/smsfabric.git
    cd smsfabric
    pnpm install
  2. ابن الحزمة والخادم.

    نافذة طرفيّة
    pnpm --filter @smsfabric/sdk build
    pnpm --filter @smsfabric/mcp-server build
  3. وجّه العميل إلى الملف المبني بمسار كامل: الأمر node والوسيط /path/to/smsfabric/packages/mcp-server/dist/cli.js.

يشغّل MCP Inspector الخادم ويتيح لك استدعاء كل أداة يدويًا دون مساعد:

نافذة طرفيّة
npx @modelcontextprotocol/inspector -e SMSFABRIC_API_KEY=sf_test_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx npx -y @smsfabric/mcp-server

افتح العنوان الذي يطبعه، وانقر Connect ثم List Tools. شغّل list_devices: هي أداة قراءة فقط، فهي استدعاء أول آمن. إذا فشل شيء، راجع حل المشكلات.