/ الدليل / الملعب / IBM Context Forge
← كل الخوادم ↗ GitHub
● رسمي IBM 🔑 يتطلب مفتاحك

IBM Context Forge

بواسطة IBM · IBM/mcp-context-forge

بوابة AI من IBM للأساطيل MCP — فدّر الخوادم وأضف المصادقة والتحكم في المعدل والرصد وترجمة REST/gRPC إلى MCP على نطاق واسع.

ContextForge هي بوابة مفتوحة المصدر وسجل وكيل (proxy) تقف أمام عدة خوادم MCP / A2A / REST / gRPC. تكشف نقطة نهاية MCP موحدة واحدة مع مصادقة مركزية والتحكم في معدل الطلبات وتتبع OpenTelemetry وواجهة إدارة. موجهة للمؤسسات التي تحتاج لإدارة عشرات خوادم MCP وليس مجرد تشغيل واحد.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

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

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

mcp-context-forge.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcp-context-forge": {
      "command": "uvx",
      "args": [
        "mcp-context-forge"
      ]
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcp-context-forge": {
      "command": "uvx",
      "args": [
        "mcp-context-forge"
      ]
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcp-context-forge": {
      "command": "uvx",
      "args": [
        "mcp-context-forge"
      ]
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp-context-forge": {
      "command": "uvx",
      "args": [
        "mcp-context-forge"
      ]
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcp-context-forge",
      "command": "uvx",
      "args": [
        "mcp-context-forge"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "mcp-context-forge": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-context-forge"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add mcp-context-forge -- uvx mcp-context-forge

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

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

استخدامات عملية: IBM Context Forge

تركيز 10+ خوادم MCP خلف بوابة واحدة

👤 مهندسو البنية التحتية في المؤسسات المتوسطة والكبيرة ⏱ ~120 min advanced

متى تستخدمه: فرق مختلفة تشغل MCPs مختلفة. تحتاج عنوان URL واحد للعملاء وسجل تدقيق واحد وقصة مصادقة واحدة.

المتطلبات الأساسية
  • بيئة Docker/Kubernetes — صور رسمية على ghcr.io؛ مخطط Helm متاح
  • موفر مصادقة (أو استخدم JWT مدمج) — SSO / OIDC موجود / موقِّع JWT ثابت
الخطوات
  1. نشر البوابة
    انشر mcp-contextforge-gateway عبر Helm مع Redis لحالة الفدرالية. وجهه إلى موفر OIDC لدينا.✓ تم النسخ
    → تحميل واجهة الإدارة، المصادقة تعمل
  2. تسجيل الخوادم الخلفية
    سجل 3 MCPs خلفية (github, postgres, our-custom) في واجهة الإدارة. طبق حدود المعدل: github=100/min, postgres=30/min.✓ تم النسخ
    → تظهر الخوادم الخلفية كصحية في السجل
  3. إعادة توجيه العملاء
    حدّث إعدادات Claude Desktop للزملاء لاستخدام mcp-remote https://mcp-gw.company.com/mcp واحد مع JWT الخاص بهم.✓ تم النسخ
    → جميع الأدوات الخلفية متاحة من خلال اتصال واحد

النتيجة: مكان واحد لإدارة وصول MCP عبر المؤسسة — مركزي مثل أي بوابة API أخرى.

المزالق
  • تطبيق حدود المعدل عالمياً لكن الفرق لها احتياجات مختلفة — استخدم حدود معدل لكل مستخدم أو لكل مطالبة JWT عبر محرك السياسة — لا تطبق حد واحد على الجميع
  • تصبح البوابة نقطة فشل واحدة — قم بتشغيل نسختين على الأقل مع حالة الجلسة المدعومة بـ Redis؛ افحص نقطة نهاية /health
اجمعها مع: cloud-run

تجريد REST API كـ MCP دون كتابة خادم

👤 مهندسو البنية التحتية بدون موارد Python/TS ⏱ ~60 min intermediate

متى تستخدمه: لديك REST API داخلي مع مواصفات OpenAPI. تريد وصول MCP بدون كتابة كود fastapi-mcp أو FastMCP.

المتطلبات الأساسية
  • مواصفات OpenAPI / Swagger للـ API — عادة /openapi.json أو /swagger.json
الخطوات
  1. تحميل مواصفات OpenAPI
    في إدارة ContextForge، سجل خادم REST جديد. حمّل مواصفات OpenAPI. أكد أن الإنشاء التلقائي للأدوات التقط جميع نقاط النهاية.✓ تم النسخ
    → قائمة الأدوات تطابق قائمة المسارات
  2. تكوين مرور المصادقة
    قم بإعداد إعادة توجيه الرأس بحيث يتدفق رأس Authorization من عميل MCP إلى REST API العلوي.✓ تم النسخ
    → تعمل المسارات المصرح بها بشكل شامل
  3. تصفية السطح المعروض
    استبعد المسارات الداخلية/الإدارية عبر أنماط المسار. أضف تجاوز الوصف على أكثر 3 أدوات استخداماً.✓ تم النسخ
    → قائمة أدوات نظيفة وسهلة الاستخدام

النتيجة: REST-as-MCP بدون أي كود خدمة جديد — مواصفات OpenAPI كافية.

المزالق
  • أسماء الأدوات المُنشأة تلقائياً سيئة — عيّن operationIds صريحة في مواصفات OpenAPI الخاصة بك أو تجاوز الأسماء في ContextForge لكل مسار

إضافة التتبع والتحليلات إلى جميع استدعاءات MCP عبر منظمتك

👤 قادة SRE / مراقبة البنية التحتية ⏱ ~90 min advanced

متى تستخدمه: تريد الإجابة على 'ماذا فعلت الوكلاء اليوم؟' عبر كل فريق يستخدم MCP.

المتطلبات الأساسية
  • خادم OTel (Phoenix, Jaeger, Grafana Tempo) — نقطة نهاية متشغلة تقبل OTLP
الخطوات
  1. تفعيل تصدير OTel
    قم بتكوين otel.endpoint للبوابة للإشارة إلى نسخة Phoenix الخاصة بنا. أضف اسم الأداة والكمون والمستخدم والنتيجة في الرتب.✓ تم النسخ
    → تظهر الرتب في Phoenix في غضون ثوان من الاستدعاءات
  2. بناء لوحات المعلومات
    أنشئ لوحات معلومات: أفضل 10 أدوات حسب حجم الاستدعاء، كمون p95 لكل خادم خلفي، معدلات الأخطاء لكل مستخدم.✓ تم النسخ
    → تم ملء لوحات المعلومات
  3. إنبيهات الشذوذ
    انبيهات على: معدل خطأ >5% لأي خادم خلفي، أو مستخدم واحد يحرق >10k استدعاء/ساعة.✓ تم النسخ
    → تنبيهات الاختبار تطلق في التدريج

النتيجة: رؤية MCP على مستوى المؤسسة — تعرف من يستخدم ماذا ومتى ينقطع.

المزالق
  • تفجر عدد الرتب OTel بسبب معرفات لكل طلب كأسماء الرتب — احتفظ بأسماء الرتب كأسماء الأدوات؛ ضع معرفات الطلب في الخصائص وليس الأسماء
اجمعها مع: sentry

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

mcp-context-forge + cloud-run

انشر ContextForge على Cloud Run، فدّر MCPs المستضافة على GCP خلفه

انشر ContextForge إلى Cloud Run مع مصادقة IAM. سجل أجهزة MCPs الداخلية الثلاثة الخاصة بنا (أيضاً على Cloud Run) كخوادم خلفية.✓ تم النسخ
mcp-context-forge + sentry

إرسال تتبع البوابة + الأخطاء إلى Sentry لرؤية العمليات

قم بتكوين تصدير OTel للبوابة ليقوم أيضاً بدفع الأخطاء إلى Sentry لرؤية الدوران.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
Gateway federation N registered backends على مستوى البنية التحتية؛ ليست أداة لكل طلب free
REST → MCP virtualization OpenAPI spec + target URL إدراج خدمة REST في MCP passthrough of target API costs
gRPC → MCP translation gRPC service descriptor نفس ما سبق، لخوادم gRPC passthrough
Prompt registry Jinja2 templates + variables شارك الأوامر عبر الفرق مع الإصدارات free
Resource registry URI-based resources اكشف محتوى منظمة ثابت / ديناميكي free
Admin API / UI HTTP + web UI مهام الحقل / التكوين free

التكلفة والحدود

تكلفة التشغيل

حصة API
مستضاف ذاتياً — أي شيء تدعمه البنية التحتية الخاصة بك
الرموز لكل استدعاء
تضيف البوابة ~50ms + حمل مخطط ضئيل
التكلفة المالية
مفتوح المصدر (Apache 2.0)؛ تدفع مقابل البنية التحتية + الخوادم الخلفية
نصيحة
ابدأ بخادم SQLite لـ <10 خوادم؛ انتقل إلى فدرالية Redis فقط عندما تحتاج إلى HA متعدد العقد

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: مفاتيح التوقيع JWT في مدير الأسرار؛ أبداً في متغيرات البيئة على صور الحاويات
نقل البيانات الخارجي: البوابة → جميع الخوادم الخلفية المكونة؛ OTel → خادم التتبع

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

تم وضع علامة على الخادم الخلفي كغير صحي لكنه يعمل عند الاختبار مباشرة

تستخدم فحوصات الصحة HEAD أو GET /؛ قد يرد الخادم الخلفي فقط على POST. قم بتكوين health_check.path لكل خادم خلفي.

فشل التحقق من صحة JWT

تحقق من تطابق مطالبات iss و aud مع إعداد البوابة. تحقق أيضاً من أن نقطة نهاية JWKS قابلة للوصول من جراب البوابة.

حد المعدل عدواني جداً أثناء الطفرات

انتقل من fixed-window إلى سياسة token-bucket؛ عيّن burst=5× المتوسط.

حلقات تسجيل دخول واجهة الإدارة

يجب أن يطابق Redirect URI في موفر OIDC الخاص بك /auth/callback على عنوان URL الخارجي للبوابة — تحقق من أنه معيّن للاسم المضيف العام الدقيق.

البدائل

IBM Context Forge مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Kong / Apigee + custom pluginsتشغلها بالفعل وتريد التوسع بدلاً من إضافة بوابة جديدةيحتاج لتطوير plugin؛ MCP ليست من الدرجة الأولى
mcp-use server namespaceحالة المطور الواحد — فقط اربط عدة MCPs من جانب العميللا توجد حوكمة مركزية؛ جيد للأفراد وليس المنظمات
Cloudflare AI Gatewayتريد بوابة SaaS مستضافة وليست مستضافة ذاتياًوظائف أقل خاصة بـ MCP؛ تركيز أساسي على حركة LLM

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills