ماذا يفعل خادم “مخطط OpenAPI” MCP؟

خادم مخطط OpenAPI MCP هو خادم بروتوكول سياق النماذج (MCP) صُمم ليتيح معلومات مخطط OpenAPI لنماذج اللغة الكبيرة (LLMs) مثل Claude. من خلال توفير وصول منظم إلى مواصفات OpenAPI، يمكّن هذا الخادم مساعدين الذكاء الاصطناعي من استكشاف وفهم واجهات البرمجة، بما في ذلك نقاطها النهائية، والمعاملات، ومخططات الطلب والاستجابة، والمزيد. هذا يمكّن المطورين وأدوات الذكاء الاصطناعي من الاستعلام عن هياكل API، والبحث عبر المواصفات، واسترجاع تعريفات المخططات التفصيلية، مما يعزز سير العمل المتعلق بتكامل API، والتوثيق، وتوليد الشيفرة. يدعم الخادم تحميل ملفات OpenAPI بصيغتي JSON أو YAML، ويقدم النتائج بصيغة YAML لتحسين فهم LLM.

قائمة المحفزات

لا توجد قوالب محفزات صريحة موثقة في المستودع.

قائمة الموارد

لا توجد موارد صريحة موصوفة في المستودع.

قائمة الأدوات

يقدم خادم مخطط OpenAPI MCP الأدوات التالية لـ LLMs:

• list-endpoints: يعرض جميع مسارات API وطرق HTTP الخاصة بها مع ملخصات بهيكل كائن متداخل.
• get-endpoint: يسترجع معلومات مفصلة حول نقطة نهاية محددة، بما في ذلك المعاملات والاستجابات.
• get-request-body: يوفر مخطط جسم الطلب لنقطة نهاية وطريقة HTTP محددة.
• get-response-schema: يعيد مخطط الاستجابة لنقطة نهاية وطريقة ورمز حالة محددين.
• get-path-parameters: يجلب المعاملات لمسار محدد.
• list-components: يعرض جميع مكونات المخططات (مخططات، استجابات، معاملات، إلخ).
• get-component: يعيد التعريف التفصيلي لمكون محدد.
• list-security-schemes: يعرض جميع مخططات الأمان المتاحة في API.
• get-examples: يسترجع أمثلة لمكون أو نقطة نهاية محددة.
• search-schema: يبحث عبر المسارات والعمليات والمخططات في مواصفة OpenAPI.

حالات استخدام هذا الخادم MCP

• استكشاف API والتوثيق: يمكن للمطورين أو LLMs عرض النقاط النهائية والمعاملات والمخططات بسرعة، مما يسهل توثيق أو فهم بنية API.
• توليد الشيفرة المؤتمتة: باسترجاع مخططات الطلب والاستجابة برمجياً، يمكن للأدوات توليد مكتبات عملاء أو مقتطفات شيفرة للتعامل مع API.
• اختبار API والتحقق من الصحة: يمكن لأدوات الاختبار استخدام هذا الخادم لجلب المعاملات وحمولات الأمثلة، لدعم اختبار API المؤتمت أو اليدوي.
• مراجعة الأمان: تحليل مخططات الأمان المتاحة وتطبيقها على النقاط النهائية لضمان تأمين APIs بشكل مناسب.
• البحث في المخططات والتحليل: إيجاد وتحليل مكونات المخطط أو النقاط النهائية المتعلقة بكائن أو ميزة معينة ضمن مواصفات API كبيرة.

كيفية إعداده

Windsurf

لا توجد تعليمات إعداد مقدمة لـ Windsurf.

Claude

1. تأكد من تثبيت Node.js و npx.
2. حدد موقع ملف إعدادات Claude Desktop:
   • macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: $env:AppData\Claude\claude_desktop_config.json
3. أضف خادم مخطط OpenAPI MCP ضمن كائن mcpServers:

   {
     "mcpServers": {
       "OpenAPI Schema": {
         "command": "npx",
         "args": ["-y", "mcp-openapi-schema", "/ABSOLUTE/PATH/TO/openapi.yaml"]
       }
     }
   }
   

4. احفظ الملف وأعد تشغيل Claude Desktop.
5. تحقق من توفر الخادم في واجهة مستخدم Claude.

Cursor

لا توجد تعليمات إعداد مقدمة لـ Cursor.

Cline

Claude Code CLI

1. تأكد من تثبيت Node.js و npx.
2. أضف خادم مخطط OpenAPI MCP:

   claude mcp add openapi-schema npx -y mcp-openapi-schema
   

   أو مع ملف مخطط محدد:

   claude mcp add petstore-api npx -y mcp-openapi-schema ~/Projects/petstore.yaml
   

3. تحقق من التسجيل:

   claude mcp list
   claude mcp get openapi-schema
   

4. اختيارياً، أزل الخادم:

   claude mcp remove openapi-schema
   

5. استخدم الأدوات في جلسة Claude Code الخاصة بك.

تأمين مفاتيح API

لا توجد معلومات مقدمة حول تأمين مفاتيح API أو استخدام متغيرات البيئة.

كيفية استخدام هذا MCP داخل التدفقات

استخدام MCP في FlowHunt

لدمج خوادم MCP في سير عمل FlowHunt الخاص بك، ابدأ بإضافة مكون MCP إلى التدفق الخاص بك وربطه بوكيل الذكاء الاصطناعي:

انقر على مكون MCP لفتح لوحة الإعدادات. في قسم إعدادات النظام MCP، أدخل تفاصيل خادم MCP الخاص بك باستخدام هذا التنسيق لـ JSON:

{
  "MCP-name": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بعد الإعداد، يصبح وكيل الذكاء الاصطناعي قادراً على استخدام هذا MCP كأداة مع إمكانية الوصول إلى جميع وظائفه وقدراته. تذكّر تغيير “MCP-name” إلى الاسم الفعلي لخادم MCP الخاص بك (مثل “github-mcp”، “weather-api”، إلخ) واستبدال رابط URL برابط خادم MCP الخاص بك.

نظرة عامة

استناداً إلى الوثائق المتاحة، فإن خادم مخطط OpenAPI MCP متخصص جداً في استكشاف OpenAPI عبر LLMs، ويوفر مجموعة أدوات قوية لكنه يفتقر لتفاصيل حول المحفزات، والموارد، ومعالجة مفاتيح API، وميزات MCP المتقدمة. بالنسبة لحالات استخدام OpenAPI، فهو قوي؛ أما للميزات الأوسع في MCP فهو محدود.

درجة MCP

التقييم:
أقيّم هذا الخادم MCP بـ 6 من 10. على الرغم من أنه محدد جيداً لاستكشاف مخططات OpenAPI ويقدم مجموعة قوية من الأدوات، إلا أنه يفتقر للوثائق حول قوالب محفزات MCP، وتعريفات الموارد الصريحة، وأفضل ممارسات الأمان، ولا يذكر دعم الجذور أو العينات. كما أن غياب الرخصة يمثل قيداً كبيراً للتعاون المفتوح.