使用说明
Medusa Admin MCP Server (Vercel Ready)
سيرفر MCP جاهز للعمل على بيئة Vercel، يوفر أدوات ذكية للتحكم بمتجر Medusa v2 الخاص بك عبر الذكاء الاصطناعي (مثل Claude Desktop أو Cursor).
✨ المميزات
- جاهز لـ Vercel: إعدادات
vercel.jsonمهيئة مسبقاً للعمل كـ Serverless Function. - آمن (Safe Writes): عمليات التعديل والحذف تتطلب خطوة تأكيد إضافية.
- SSE Support: يدعم Server-Sent Events للاتصال المستقر.
🚀 النشر على Vercel (Deployment)
- ارفع الكود إلى GitHub.
- استورد المشروع في Vercel.
- أضف المتغيرات البيئية (Environment Variables):
| المتغير | الوصف | مثال |
|---|---|---|
MEDUSA_BASE_URL |
رابط Medusa Backend | https://your-medusa.koyeb.app |
MEDUSA_AUTH_TOKEN |
مفتاح API للأدمن | sk_123... |
MEDUSA_AUTH_MODE |
وضع المصادقة | basic |
CONFIRM_SECRET |
كلمة سرية طويلة | random_string |
REQUIRE_CONFIRM |
تفعيل التأكيد | true |
DATABASE_URL |
رابط قاعدة البيانات (Neon Postgres) | postgresql://... |
STOREFRONT_URL |
رابط الواجهة الأمامية | https://mero-store.com |
🛠️ أدوات جديدة (New Capabilities)
تمت إضافة أدوات للتعامل المباشر مع قاعدة البيانات والواجهة:
-
Database Tools:
db_list_tables: عرض جميع الجداول.db_get_table_schema: معرفة هيكل جدول معين.db_run_read_only_query: تنفيذ استعلام SQL (قراءة فقط) بأمان.
-
Storefront Debugging:
storefront_check_payment_providers: فحص بوابات الدفع من قاعدة البيانات.storefront_ping: التأكد من أن رابط المتجر يعمل.
🔌 طريقة الاستخدام (Connecting to Clients)
رابط السيرفر الخاص بك سيكون:
https://YOUR-PROJECT.vercel.app/mcp
✅ الطريقة الصحيحة (Claude Desktop & Cursor)
أضف الإعدادات التالية في ملف التكوين (claude_desktop_config.json أو في إعدادات MCP في Cursor):
{
"mcpServers": {
"MedusaAdmin": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://YOUR-PROJECT.vercel.app/mcp"
]
}
}
}
ملاحظة: نستخدم
mcp-remoteكجسر للاتصال بالسيرفر البعيد. تأكد من كتابة الرابط معhttps://.
⚠️ ملاحظات هامة
- تأكد من أن رابط Medusa يعمل (
MEDUSA_BASE_URL). - تأكد من صحة
MEDUSA_AUTH_TOKEN. - إذا واجهت مشاكل في الاتصال، تأكد من تحديث ملف
src/index.tsليدعمGETrequests (تم التحديث في أحدث نسخة).
