أي خادم MCP لـ OpenAPI

ما وظيفة خادم MCP “Any OpenAPI”؟

خادم MCP “Any OpenAPI” هو أداة مصممة لربط المساعدين الذكيين—مثل Claude—بأي API خارجي يعرض مواصفة OpenAPI (Swagger). يتيح البحث الدلالي في مستندات OpenAPI الكبيرة، ويقوم بتجزئة نقاط النهاية بذكاء لاكتشافها والتفاعل معها بسرعة. هذا يسمح للعملاء الذكيين باكتشاف نقاط النهاية ذات الصلة من خلال استعلامات باللغة الطبيعية (مثال: “عرض المنتجات”)، واسترجاع توثيق النقطة بالكامل فوراً، وتنفيذ طلبات API مباشرة من الخادم. يُعد الخادم مثالياً لتكامل واجهات البرمجة الخاصة أو الكبيرة في تدفقات العمل المدعومة بالذكاء الاصطناعي، مما يبسط العمليات مثل استعلامات قواعد البيانات أو تكاملات API المخصصة بدون الحاجة لتحديثات يدوية متكررة.

قائمة القوالب (Prompts)

لا توجد قوالب محددة مذكورة في الوثائق أو الشيفرة المتوفرة.

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

لا توجد موارد MCP صريحة مدرجة أو موصوفة في الوثائق أو الشيفرة المتوفرة.

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

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

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

• تكامل API للخدمات الخاصة
  اربط Claude أو المساعدين الآخرين بسلاسة مع واجهات API خاصة بتوفير رابط JSON لمواصفة OpenAPI، مع تفعيل تفاعل آمن وديناميكي مع الأنظمة الداخلية.
• اكتشاف سريع لنقاط النهاية
  استخدم بحث دلالي بالذاكرة (مدعوم بـ FAISS وMiniLM-L3) للعثور السريع على نقاط النهاية ذات الصلة حتى ضمن مستندات OpenAPI كبيرة ومعقدة.
• تنفيذ آلي لطلبات API
  اسمح للعملاء الذكيين باكتشاف وتنفيذ طلبات API، مما يمكّن تدفقات عمل مثل عرض المنتجات أو إدارة الطلبات أو البحث عن المستخدمين بدون أدوات إضافية.
• وصول توثيقي سياقي للـ API
  استرجع توثيق النقاط المحددة فورياً لدعم اكتشاف التفاصيل والمعلمات واستخدامها لأتمتة معتمدة على الذكاء الاصطناعي.
• تكامل مع Claude Desktop أو عملاء مشابهين
  صُمم للعمل مع عميل MCP الخاص بـ Claude، متجاوزاً حدود حجم المستندات وممكّناً لاستخدام عملي لواجهات API كبيرة في تطبيقات الذكاء الاصطناعي المكتبية.

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

Windsurf

1. تأكد من تثبيت Node.js وWindsurf.
2. حدد موقع ملف إعدادات Windsurf الخاص بك.
3. أضف إدخال @any-openapi/mcp-server@latest إلى كائن mcpServers.
4. زوّد الأمر وأي متغيرات بيئة ضرورية (مثل OPENAPI_JSON_DOCS_URL).
5. احفظ وأعد تشغيل Windsurf ثم تحقق من ظهور الخادم كما هو متوقع.

مثال JSON:

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

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

{
  "env": {
    "API_KEY": "${ANY_OPENAPI_API_KEY}"
  },
  "inputs": {
    "apiKey": "${ANY_OPENAPI_API_KEY}"
  }
}

Claude

1. تأكد من دعم Claude لتكامل خوادم MCP.
2. افتح لوحة الإعدادات أو التكوين لخوادم MCP.
3. أدرج تفاصيل الخادم بالأمر ومتغيرات البيئة.
4. احفظ التغييرات وأعد تشغيل Claude إن لزم الأمر.
5. تحقق من اكتشاف الخادم وتفعيله.

مثال JSON:

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

Cursor

1. ثبّت Cursor وانتقل إلى قسم إعدادات خادم MCP.
2. أضف إدخال MCP جديد باستخدام حزمة @any-openapi/mcp-server@latest.
3. عيّن متغيرات البيئة حسب الحاجة لواجهة API الخاصة بك.
4. احفظ الإعدادات وأعد تشغيل Cursor.
5. تحقق من التكامل عبر عرض الأدوات المتاحة.

مثال JSON:

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

Cline

1. افتح ملف إعدادات Cline الخاص بك.
2. أضف إعداد خادم MCP لـ @any-openapi/mcp-server@latest.
3. عيّن متغيرات البيئة المطلوبة.
4. احفظ وأعد تشغيل Cline.
5. تأكد من ظهور الخادم ضمن خوادم MCP النشطة.

مثال JSON:

{
  "mcpServers": {
    "any-openapi": {
      "command": "npx",
      "args": ["@any-openapi/mcp-server@latest"],
      "env": {
        "OPENAPI_JSON_DOCS_URL": "https://yourapi.com/openapi.json"
      }
    }
  }
}

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

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

استخدام MCP في FlowHunt

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

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

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

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

نظرة عامة

دعم roots: غير محدد في الوثائق أو الشيفرة المتوفرة.

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

رأينا

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

التقييم: 7/10

نقاط MCP