خادم OpenAPI MCP

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

خادم OpenAPI MCP هو خادم بروتوكول سياق النماذج (MCP) صُمم لربط مساعدي الذكاء الاصطناعي (مثل Claude وCursor) بقدرة البحث واستكشاف مواصفات OpenAPI عبر oapis.org. من خلال عمله كجسر، يمكّن النماذج من فهم شامل للواجهات البرمجية المعقدة باستخدام لغة بسيطة. يتبع الخادم عملية من ثلاث خطوات: تحديد مواصفة OpenAPI المطلوبة، تلخيصها بلغة يسهل فهمها، وتفصيل نقاط النهاية وطريقة استخدامها. وعلى الرغم من أنه لا ينفذ نقاط النهاية مباشرة (بسبب قيود المصادقة)، إلا أنه يتفوق في تقديم ملخصات عن الواجهات البرمجية، وتسهيل توليد الشيفرات، ودعم سير عمل التطوير حيث يكون فهم وتوثيق بنية الواجهة البرمجية أمرًا أساسيًا.

قائمة التعليمات (Prompts)

• تعليمات نظرة عامة: تطلب ملخصًا وفهمًا لمواصفة OpenAPI.
• تعليمات تفاصيل العمليات: تسترجع أوصافًا تفصيلية لعمليات محددة في الواجهة البرمجية.
• تعليمات تحديد نقاط النهاية: تحدد نقاط النهاية ذات الصلة بناءً على استعلام معين.

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

• نظرة عامة على مواصفات OpenAPI: تقدم ملخصات لمواصفات الواجهة البرمجية بالكامل.
• تفاصيل عمليات الواجهة البرمجية: تزود بسياق حول نقاط النهاية المحددة ومعاملاتها.
• مرونة في التنسيق: تدعم مواصفات الواجهة البرمجية بصيغة JSON وYAML.
• مورد التوافقية: تم اختبار الموارد مع Claude Desktop وCursor لتوصيل السياق بسلاسة.

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

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

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

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

كيفية الإعداد

Windsurf

1. تأكد من تثبيت Node.js على نظامك.
2. افتح ملف إعدادات Windsurf.
3. أضف خادم OpenAPI MCP إلى قسم mcpServers باستخدام المقطع البرمجي (JSON) المقدم.
4. احفظ الإعدادات وأعد تشغيل Windsurf.
5. تحقق من الاتصال بخادم MCP.

مثال للإعداد:

{
  "mcpServers": {
    "openapi-mcp": {
      "command": "npx",
      "args": ["@janwilmake/openapi-mcp-server@latest"],
      "env": {
        "OAS_API_KEY": "${OAS_API_KEY}"
      }
    }
  }
}

ملاحظة: قم بتأمين مفاتيح الواجهة البرمجية باستخدام متغيرات البيئة كما هو موضح أعلاه.

Claude

1. قم بتثبيت Node.js.
2. ادخل إلى إعدادات تكامل MCP في Claude.
3. أضف خادم OpenAPI MCP بالإعداد التالي.
4. احفظ الإعدادات وأعد تشغيل Claude.
5. تأكد من توفر الخادم كمورد MCP.

مثال للإعداد:

{
  "mcpServers": {
    "openapi-mcp": {
      "command": "npx",
      "args": ["@janwilmake/openapi-mcp-server@latest"],
      "env": {
        "OAS_API_KEY": "${OAS_API_KEY}"
      }
    }
  }
}

Cursor

1. تأكد من تثبيت Node.js.
2. حدد موقع ملف إعدادات Cursor.
3. أدخل خادم OpenAPI MCP تحت mcpServers.
4. احفظ وأعد تشغيل Cursor.
5. اختبر باستعلام OpenAPI تجريبي.

مثال للإعداد:

{
  "mcpServers": {
    "openapi-mcp": {
      "command": "npx",
      "args": ["@janwilmake/openapi-mcp-server@latest"],
      "env": {
        "OAS_API_KEY": "${OAS_API_KEY}"
      }
    }
  }
}

Cline

1. ثبت Node.js إن لم يكن مثبتًا.
2. عدل ملف إعدادات Cline ليشمل OpenAPI MCP.
3. أضف الكتلة البرمجية التالية (JSON).
4. احفظ التعديلات وأعد تشغيل Cline.
5. تأكد من أن خادم MCP نشط.

مثال للإعداد:

{
  "mcpServers": {
    "openapi-mcp": {
      "command": "npx",
      "args": ["@janwilmake/openapi-mcp-server@latest"],
      "env": {
        "OAS_API_KEY": "${OAS_API_KEY}"
      }
    }
  }
}

تأمين مفاتيح الواجهة البرمجية:
قم بتخزين المفاتيح الحساسة في متغيرات البيئة وارجع إليها في إعداداتك كما هو موضح في خاصية env.

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

استخدام MCP في FlowHunt

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

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

{
  "openapi-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بعد الإعداد، سيتمكن وكيل الذكاء الاصطناعي من استخدام هذا MCP كأداة مع كل وظائفه وإمكاناته. تذكر تغيير “openapi-mcp” إلى اسم خادم MCP الفعلي الخاص بك واستبدال عنوان URL بعنوان خادم MCP الخاص بك.

نظرة عامة

رأينا

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

درجة MCP