/ الدليل / الملعب / toolhive
● مجتمع stacklok ⚡ فوري

toolhive

بواسطة stacklok · stacklok/toolhive

قم بتشغيل خوادم MCP في حاويات معزولة مع التثبيت بنقرة واحدة وسجل منظم و SSO ودعم Kubernetes.

ToolHive (Stacklok) هي منصة على مستوى المؤسسة لتشغيل خوادم MCP. بوابة + سجل + وقت تشغيل الحاويات + بوابة ويب. موجهة نحو نشر الفريق والمؤسسة حيث تريد خوادم MCP معزولة بأقل الصلاحيات و SSO وسجلات التدقيق وسجل منظم.

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

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

عرض مباشر

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

toolhive.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "toolhive": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/stacklok/toolhive"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "toolhive": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/stacklok/toolhive"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "toolhive": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/stacklok/toolhive"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "toolhive": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/stacklok/toolhive"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "toolhive",
      "command": "TODO",
      "args": [
        "See README: https://github.com/stacklok/toolhive"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "toolhive": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/stacklok/toolhive"
        ]
      }
    }
  }
}

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

claude mcp add toolhive -- TODO 'See README: https://github.com/stacklok/toolhive'

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

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

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

كيفية تثبيت خادم MCP مجتمعي دون الثقة بنصوص `npx -y` عشوائية

👤 المهندسون الذين يعطون الأولوية للأمان ⏱ ~10 min beginner

متى تستخدمه: تريد تشغيل خادم MCP GitHub محلياً لكن لا تريد منحه وصولاً غير محدود لنظام الملفات.

المتطلبات الأساسية
  • Docker Desktop — docker.com
  • تطبيق ToolHive لسطح المكتب — stacklok.com/download
الخطوات
  1. افتح ToolHive وابحث في السجل
    قم بتثبيت 'github' من سجل ToolHive.✓ تم النسخ
    → تم سحب الحاوية وطلب إعداد GITHUB_TOKEN
  2. قم بإعداد عميلك تلقائياً
    انقر على 'الاتصال بـ Claude Desktop'.✓ تم النسخ
    → تم تحديث إعداد Claude Desktop ويلزم إعادة التشغيل
  3. تحقق من العزلة
    تأكد من أن الحاوية تحتوي فقط على متغيرات البيئة التي عينتها وبدون نقاط تركيب نظام الملفات على المضيف.✓ تم النسخ
    → فحص إعدادات الحاوية في واجهة ToolHive

النتيجة: خادم MCP معزول بأقل صلاحيات للوصول إلى جهازك.

المزالق
  • خوادم MCP لنظام الملفات تحتاج إلى نقطة تركيب — عدم التركيب الافتراضي محكم جداً — أضف نقطة تركيب ذات نطاق (مثلاً ~/Projects فقط) بدلاً من المنزل الكامل

كيفية نشر خوادم MCP على Kubernetes لفريق المنصة

👤 مهندسو المنصة ⏱ ~60 min advanced

متى تستخدمه: تريد توافر خادم MCP موحد على مستوى المؤسسة.

المتطلبات الأساسية
  • مجموعة Kubernetes + مسؤول المجموعة — EKS/GKE/AKS الموجود أو kind للتطوير
  • تم تثبيت ToolHive Operator CRDs — kubectl apply -f the Stacklok-provided manifests
الخطوات
  1. أعلن عن موارد MCPServer
    kubectl apply -f mcp-github.yaml — سجل خادم MCP GitHub بشكل تصريحي مع أسرار ذات نطاق.✓ تم النسخ
    → Pod قيد التشغيل؛ البوابة تسرده
  2. اكشف للمستخدمين عبر البوابة
    يسجل المهندسون الدخول إلى البوابة باستخدام SSO والتثبيت بنقرة واحدة في عميلهم.✓ تم النسخ
    → يتم إنشاء الإعدادات لكل مستخدم تلقائياً

النتيجة: سجل مركزي + تثبيت لكل مستخدم؛ قابل للتدقيق.

المزالق
  • خوادم Stdio MCP لا تناسب Kubernetes المكشوفة على الشبكة جيداً — فضّل خوادم Streamable HTTP MCP لـ k8s؛ استخدم البوابة لخوادم stdio

كيفية إنتاج مسار تدقيق لجميع استدعاءات أدوات MCP

👤 فرق الامتثال والأمان ⏱ ~30 min intermediate

متى تستخدمه: تحتاج مؤسستك إلى 'من استدعى أي أداة ومتى' لـ SOC2 أو السياسة الداخلية.

الخطوات
  1. تفعيل تصدير OpenTelemetry
    في إعدادات ToolHive، عيّن نقطة نهاية OTLP إلى مجمعك.✓ تم النسخ
    → تظهر آثار (traces) في خادمك الخلفي
  2. ضع وسم حسب المستخدم
    فعّل نشر الهوية لكل مستخدم عبر SSO.✓ تم النسخ
    → كل أثر له معرف الفاعل

النتيجة: سجل تدقيق لكل مستخدم ولكل أداة.

التركيبات

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

toolhive + mcphub

استخدم ToolHive للعزلة و MCPHub لتوجيه الخوادم المتعددة

قم بتشغيل كل خادم MCP في حاويته الخاصة بـ ToolHive واكشف عنها من خلال مجموعات MCPHub.✓ تم النسخ
toolhive + unla

دمج خوادم MCP التي تعمل بـ ToolHive مع تحويل REST-to-MCP من Unla

سجل API الداخلي المحول بـ Unla في ToolHive ليعمل في حاوية مع SSO.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
(platform) registry-install mcp_name تثبيت خادم MCP موثق مجاني
(platform) gateway-proxy النقل + سياسة المصادقة واجهة خوادم MCP الخاصة بك مع السياسة مجاني
(platform) runtime-isolate مواصفات الحاوية التنفيذ في بيئة معزولة مجاني + تكلفة البنية التحتية

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

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

حصة API
لا توجد حصة على مستوى المنصة
الرموز لكل استدعاء
عبء إضافي ضئيل
التكلفة المالية
تطبيق سطح المكتب + CLI + عامل التشغيل مفتوح المصدر مجاني. خطط المؤسسة للدعم والامتثال.
نصيحة
ابدأ بالمستوى المجاني؛ ارقِ فقط إذا كنت تحتاج إلى SLAs مخصصة أو SSO/RBAC متقدم.

الأمان

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

الحد الأدنى من الصلاحيات: لكل خادم MCP: أقل صلاحيات لمتغيرات البيئة ونقاط التركيب SSO لنشر الفريق
تخزين بيانات الاعتماد: مدير الأسرار المشفرة المدمج في ToolHive
نقل البيانات الخارجي: يتم تحديده بواسطة خوادم MCP النهائية؛ تضيف ToolHive القياس عن بعد إذا تم تكوينها
لا تمنح أبدًا: لا تمنح نقاط تركيب نظام الملفات تلقائياً بما يتجاوز ما يحتاجه كل خادم MCP

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

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

تبدأ الحاوية ثم تخرج فوراً

تحقق من تعيين متغيرات البيئة المطلوبة لخادم MCP (مثلاً GITHUB_TOKEN). اعرض السجلات في واجهة ToolHive.

لا يستطيع Claude Desktop العثور على الخادم بعد التثبيت

أعد تشغيل Claude Desktop — تحميل تغييرات الإعداد فقط عند البدء.

يفشل تثبيت K8s Operator CRD

تأكد من وجود cluster-admin و إصدار k8s مدعوم (>= 1.27).

تحقق: kubectl version
آثار OTLP مفقودة

يجب أن تقبل نقطة نهاية Collector OTLP/HTTP أو OTLP/gRPC؛ تأكد من تطابق البروتوكول.

البدائل

toolhive مقابل البدائل

البديلمتى تستخدمهاالمقايضة
MCPHubتريد تجميع الخوادم المتعددة أكثر من العزلة على مستوى الحاوياتلا تركيز على وقت تشغيل الحاويات
Docker MCP Toolkitتفضل الأدوات المدمجة الخاصة بـ Dockerسجل أقل تنظيماً

المزيد

الموارد

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

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

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