خادم Shopify.dev MCP - أداة للتفاعل مع منصة تطوير Shopify عبر بروتوكول سياق النموذج

خادم Shopify.dev MCP

نظرة عامة على المشروع

خادم Shopify.dev MCP هو خادم ينفذ بروتوكول سياق النموذج (Model Context Protocol, MCP)، وهو مخصص للتفاعل مع منصة تطوير Shopify. يوفر هذا المشروع للمطورين مجموعة أدوات قوية للوصول إلى مختلف واجهات برمجة تطبيقات Shopify (APIs) والتعامل معها.

الوظائف الأساسية

الأدوات المدعومة

اسم الأداة	الوصف
search_dev_docs	البحث في وثائق Shopify.dev الرسمية
introspect_admin_schema	الوصول إلى مخطط Shopify Admin GraphQL والبحث فيه

قوالب المطالبات المضمنة

اسم المطالبة	الوصف
shopify_admin_graphql	المساعدة في كتابة عمليات GraphQL لواجهة برمجة تطبيقات Shopify Admin

التثبيت والاستخدام

التشغيل السريع

يمكنك تشغيل خادم Shopify MCP بسرعة باستخدام أمر npx:

npx -y @shopify/dev-mcp@latest

طرق التكوين

التكوين العام

أضف التكوين التالي إلى عميل MCP الخاص بك. لمزيد من المعلومات، يرجى الرجوع إلى وثائق Cursor MCP أو دليل Claude Desktop MCP:

{
  "mcpServers": {
    "shopify-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@shopify/dev-mcp@latest"]
    }
  }
}

تكوين نظام Windows

في نظام Windows، قد تحتاج إلى استخدام التكوين البديل التالي:

{
  "mcpServers": {
    "shopify-dev-mcp": {
      "command": "cmd",
      "args": ["/k", "npx", "-y", "@shopify/dev-mcp@latest"]
    }
  }
}

إعداد بيئة التطوير

تثبيت التبعيات

npm install

سير عمل التطوير

1. تعديل ملفات المصدر - قم بتعديل كود مصدر المشروع
2. تجميع المشروع - قم بتشغيل الأمر التالي للتجميع:

   npm run build
   

3. تشغيل الاختبارات - قم بتنفيذ حالات الاختبار:

   npm run test
   

4. التشغيل المحلي - أضف تكوين خادم MCP، وقم بتشغيل الأمر التالي:

   node <المسار المطلق للمشروع>/dist/index.js
   

البنية التقنية

التقنيات الأساسية

• MCP SDK: يعتمد المشروع على بناء MCP SDK
• Node.js: يستخدم Node.js كبيئة تشغيل
• TypeScript: يستخدم TypeScript للتطوير (افتراض)
• GraphQL: يدعم عمليات Shopify Admin GraphQL API

بروتوكول الاتصال

يتواصل الخادم مع منصة تطوير Shopify من خلال بروتوكول سياق النموذج، مما يوفر واجهة موحدة للوصول إلى موارد تطوير Shopify المختلفة.

حالات الاستخدام

تكامل أدوات المطورين

• تكامل IDE: يمكن دمجه في بيئات التطوير التي تدعم MCP، مثل Cursor
• مساعد الذكاء الاصطناعي: يمكن استخدامه مع أدوات الذكاء الاصطناعي مثل Claude Desktop
• البحث عن الوثائق: البحث السريع عن وثائق Shopify الرسمية والوصول إليها
• تطوير API: المساعدة في تطوير وتصحيح أخطاء GraphQL API

سير العمل النموذجي

1. البحث عن الوثائق: استخدم أداة search_dev_docs للعثور بسرعة على وثائق التطوير ذات الصلة
2. استكشاف المخطط: استخدم أداة introspect_admin_schema لفهم حقول وعمليات GraphQL المتاحة
3. إنشاء التعليمات البرمجية: استخدم قالب المطالبة shopify_admin_graphql لإنشاء استعلامات GraphQL متوافقة
4. تصحيح أخطاء API: تحقق بسرعة من استدعاءات API أثناء التطوير

مميزات المشروع

المزايا

• دعم رسمي: يتم صيانته رسميًا بواسطة Shopify، مما يضمن التوافق مع النظام الأساسي والتحديثات في الوقت المناسب
• بروتوكول قياسي: يعتمد على معيار MCP، ولديه قابلية تشغيل جيدة
• جاهز للاستخدام: يمكن استخدامه مباشرةً من خلال npx، دون عملية تثبيت معقدة
• صديق للمطور: يوفر مجموعة أدوات تطوير واختبار كاملة

الجمهور المستهدف

• مطورو تطبيقات Shopify
• مطورو القوالب
• مطورو الطرف الثالث الذين يستخدمون Shopify API
• المطورون الذين يحتاجون إلى الاستعلام عن وثائق Shopify بشكل متكرر

موارد ذات صلة

• مستودع GitHub: https://github.com/Shopify/dev-mcp
• وثائق مطوري Shopify: https://shopify.dev/
• وثائق بروتوكول MCP: https://modelcontextprotocol.io/
• وثائق Cursor MCP: https://docs.cursor.com/context/model-context-protocol

ملخص

خادم Shopify.dev MCP هو أداة تطوير قوية توفر للمطورين طريقة ملائمة للوصول إلى موارد تطوير Shopify من خلال بروتوكول موحد. سواء كنت تقوم ببناء تطبيق Shopify أو تطوير قالب أو دمج خدمة تابعة لجهة خارجية، يمكن لهذه الأداة أن تحسن بشكل كبير من كفاءة التطوير لديك.