/ الدليل / الملعب / mcphub
● مجتمع samanhappy ⚡ فوري

mcphub

بواسطة samanhappy · samanhappy/mcphub

قم بتشغيل جميع خوادم MCP خلف نقطة نهاية واحدة — قم بتجميعها، وقم بالتوجيه الذكي عبر البحث المتجهي، وقم بتبديل التكوينات دون توقف.

MCPHub هو محور TypeScript يقوم بتجميع عدة خوادم MCP تحت نقطة نهاية HTTP واحدة مع التوجيه حسب المجموعة أو الخادم أو عبر موجّه 'ذكي' يستخدم البحث المتجهي. يدعم OAuth وتسجيل الدخول الاجتماعي وسمة PostgreSQL للإنتاج. Docker هو الطريقة الموصى بها للنشر.

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

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

عرض مباشر

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

mcphub.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcphub": {
      "command": "npx",
      "args": [
        "-y",
        "mcphub"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcphub": {
      "command": "npx",
      "args": [
        "-y",
        "mcphub"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcphub": {
      "command": "npx",
      "args": [
        "-y",
        "mcphub"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcphub": {
      "command": "npx",
      "args": [
        "-y",
        "mcphub"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcphub",
      "command": "npx",
      "args": [
        "-y",
        "mcphub"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "mcphub": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcphub"
        ]
      }
    }
  }
}

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

claude mcp add mcphub -- npx -y mcphub

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

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

استخدامات عملية: mcphub

كيفية عرض 20 خادم MCP من خلال عنوان URL واحد لفريقك

👤 مهندسو البنية الأساسية، قادة الفرق ⏱ ~30 min intermediate

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

المتطلبات الأساسية
  • Docker وخادم باسم DNS — أي VPS رخيص يعمل؛ استخدم Caddy أو nginx لـ TLS
  • ملف mcp_settings.json يتضمن قائمة بخوادمك — ابدأ من عينة MCPHub وأضف مدخل واحد لكل MCP
الخطوات
  1. نشر المحور
    قم بتشغيل: docker run -p 3000:3000 -v $PWD/mcp_settings.json:/app/mcp_settings.json samanhappy/mcphub✓ تم النسخ
    → عنوان URL تسجيل دخول المسؤول + كلمة المرور المُنشأة في السجلات
  2. إنشاء مجموعات
    في واجهة المسؤول، قم بإنشاء مجموعات 'dev' (github, filesystem, postgres) و'data' (postgres, bigquery).✓ تم النسخ
    → المجموعات مرئية في /mcp/dev و/mcp/data
  3. توزيع عنوان URL
    شارك https://mcp.yourco.internal/mcp/dev مع الفريق؛ يضيفونه كـ HTTP MCP واحد في عميلهم.✓ تم النسخ
    → يتصل أعضاء الفريق بسطر تكوين واحد

النتيجة: نقطة نهاية صالحة للتشغيل واحدة تحل محل 20 إعداد لكل جهاز.

المزالق
  • تسرب كلمة المرور الخاصة بالمسؤول من سجلات Docker — قم بتعيين متغير البيئة ADMIN_PASSWORD بشكل صريح؛ قم بتدويره عند تسجيل الدخول الأول
  • عرض المحور على الإنترنت العام — ضعه خلف VPN أو اطلب رموز bearer لكل مستخدم

كيفية السماح لـ $smart باختيار MCP الصحيح لموجه تلقائياً

👤 الفرق التي تشغل عدداً كبيراً جداً من الأدوات لتناسب سياقاً واحداً ⏱ ~15 min advanced

متى تستخدمه: لديك 200+ أداة عبر MCPs وتتجاوز ميزانية أدوات نموذجك.

الخطوات
  1. تفعيل نقطة النهاية $smart
    وجّه عميلك إلى https://hub.example.com/mcp/$smart بدلاً من خادم معين.✓ تم النسخ
    → أداة meta واحدة معروضة توجّه حسب النية
  2. اكتب الموجه بشكل طبيعي
    ابحث عن PRs في github.com/org/repo التي تنتظرني وضعها في تقويمي كفتحة مراجعة مدتها 30 دقيقة.✓ تم النسخ
    → يختار المحور أدوات github + google-calendar خلف الكواليس

النتيجة: عدد أقل من الأدوات في السياق، نفس القدرة.

المزالق
  • يختار الموجّه الذكي MCP خاطئ على الموجهات الغامضة — احتفظ بنقاط النهاية الخاصة بالمجموعة متاحة كخطة احتياطية

كيفية إضافة خادم MCP جديد إلى المحور بدون توقف

👤 المشغلون ⏱ ~5 min beginner

متى تستخدمه: تم إطلاق MCP جديد للتو وتريده مباشراً اليوم بدون إزعاج الجميع.

الخطوات
  1. تحرير mcp_settings.json عبر الواجهة
    في لوحة معلومات MCPHub، أضف مدخل خادم جديد وحفظ.✓ تم النسخ
    → إخطار إعادة التحميل السريع، تظهر أدوات جديدة
  2. التعيين إلى مجموعة
    أضف الخادم الجديد إلى مجموعة 'data'.✓ تم النسخ
    → يتضمن /mcp/data الآن الأدوات الجديدة

النتيجة: MCP جديد متصل بالإنترنت في أقل من دقيقة، لا توصيلات عميل مطلوبة.

التركيبات

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

mcphub + toolhive

استخدم ToolHive لحزم MCPs الفردية في حاويات، استخدم MCPHub للتوجيه إليها

سجّل MCP github الذي يعمل في ToolHive في MCPHub تحت مجموعة 'dev'.✓ تم النسخ
mcphub + proxy

عرض MCPs stdio فقط عبر HTTP للمحور

استخدم mcp-proxy لربط MCP stdio المحلي بـ HTTP حتى يتمكن MCPHub من تجميعه.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
(meta) route-by-group HTTP path /mcp/{group} الاستخدام العادي — ضيّق نطاق تأثيرك free
(meta) route-by-server /mcp/{server} عندما تريد سطح خادم واحد بالضبط free
(meta) $smart semantic router /mcp/$smart عندما يكون لديك عدد كبير جداً من الأدوات للسياق 1 vector search per call

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

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

حصة API
لا توجد حصص مفروضة من المحور؛ تحتفظ MCPs اللاحقة بحصصها الخاصة
الرموز لكل استدعاء
يضيف حوالي 50 رمز من كسط بيانات وصفية للأداة
التكلفة المالية
مجاني (مفتوح المصدر، Apache 2.0)
نصيحة
استخدم مسارات المجموعة، وليس $smart، للحصول على سلوك حتمي وتكلفة بحث متجهي إضافية صفرية.

الأمان

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

الحد الأدنى من الصلاحيات: رمز Bearer لكل مستخدم تقييد على مستوى الشبكة للعملاء الموثوقين
تخزين بيانات الاعتماد: متغير البيئة ADMIN_PASSWORD؛ أسرار MCP اللاحقة عبر mcp_settings.json أو مدير الأسرار
نقل البيانات الخارجي: المحور يقوم فقط بالمراجعة — تذهب بياناتك حيث يرسلها كل MCP لاحق
لا تمنح أبدًا: العرض العام بدون مصادقة واجهة المسؤول على الإنترنت العام

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

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

Cannot log in / password unknown

تحقق من سجلات الحاوية عند الإقلاع الأول من كلمة المرور المُنشأة أو اضبط ADMIN_PASSWORD.

تحقق: docker logs mcphub | grep -i password
New MCP shows up but no tools

من المحتمل أن فشل بدء تشغيل MCP اللاحق. انقر على 'السجلات' على بطاقة الخادم.

Smart router returns 'no matching tool'

أعد فهرسة مخزن المتجهات من الإعدادات > أدوات الفهرس.

OAuth redirect mismatch

سجّل عنوان URL الفعلي للاستدعاء في مزود OAuth الخاص بك (يجب أن يتطابق مع عنوان URL العام للمحور).

البدائل

mcphub مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Unla (MCP Gateway)تريد تحويل REST-to-MCP يُدار بواسطة YAML بالإضافة إلى متعدد المستأجرينمستند على Go، نموذج مشغل مختلف
ToolHiveتريد عزل على مستوى الحاوية لكل MCPيركز على تشغيل MCPs، أقل على التوجيه/التجميع
mcp-proxyتحتاج فقط إلى ربط النقل، وليس تجميع خوادم متعددةخادم واحد؛ لا واجهة مستخدم

المزيد

الموارد

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

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

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