تثبيت خادم MCP
في الاستخدام المعتاد لا تشغّل الخادم بنفسك: عميل MCP يشغّله عند الحاجة. تشرح هذه الصفحة ما يشغّله العميل والمتغيرات التي يحتاجها. لإضافته إلى عميل، انتقل إلى العملاء.
المتطلبات
Section titled “المتطلبات”- Node.js 20 أو أحدث، مع وجود
npxفيPATHالخاص بالتطبيق الذي يشغّل الخادم. - مفتاح API من SMSFabric. أنشئه من المطورون ← مفاتيح API في البوابة (الشرح خطوة بخطوة) بالنطاقات التي تحتاجها فقط (أيها). ابدأ بمفتاح اختبار (
sf_test_…).
متغيرات البيئة
Section titled “متغيرات البيئة”| المتغير | مطلوب | القيمة |
|---|---|---|
SMSFABRIC_API_KEY |
نعم | sf_live_… أو sf_test_…. يتوقف الخادم عند البدء إذا غاب. |
SMSFABRIC_BASE_URL |
لا | أصل الواجهة البرمجية. الافتراضي https://api.smsfabric.com، والقيمة الفارغة تعامل كأنها غير مضبوطة. اضبطه على http://localhost:3000 لواجهة محلية. |
يمرر العميل هذه المتغيرات إلى الخادم من إعداداته، غالبًا في كتلة env.
التشغيل عبر npx
Section titled “التشغيل عبر npx”أبسط إعداد. ينزّل 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.
التثبيت العام
Section titled “التثبيت العام”التثبيت على مستوى النظام يضع الأمر smsfabric-mcp في PATH، فيشغّله العميل دون npx:
npm install -g @smsfabric/mcp-serverpnpm add -g @smsfabric/mcp-serveryarn global add @smsfabric/mcp-serverثم استخدم smsfabric-mcp أمرًا دون وسائط في إعدادات العميل. حدّثه بالأمر نفسه عند صدور إصدار جديد.
التشغيل من الكود المصدري
Section titled “التشغيل من الكود المصدري”لتجربة تغيير لم يصدر بعد، ابن الخادم من المستودع:
-
انسخ المستودع وثبّت اعتمادياته.
نافذة طرفيّة git clone https://github.com/elshahat/smsfabric.gitcd smsfabricpnpm install -
ابن الحزمة والخادم.
نافذة طرفيّة pnpm --filter @smsfabric/sdk buildpnpm --filter @smsfabric/mcp-server build -
وجّه العميل إلى الملف المبني بمسار كامل: الأمر
nodeوالوسيط/path/to/smsfabric/packages/mcp-server/dist/cli.js.
تأكد من أنه يعمل
Section titled “تأكد من أنه يعمل”يشغّل MCP Inspector الخادم ويتيح لك استدعاء كل أداة يدويًا دون مساعد:
npx @modelcontextprotocol/inspector -e SMSFABRIC_API_KEY=sf_test_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx npx -y @smsfabric/mcp-serverافتح العنوان الذي يطبعه، وانقر Connect ثم List Tools. شغّل list_devices: هي أداة قراءة فقط، فهي استدعاء أول آمن. إذا فشل شيء، راجع حل المشكلات.