/ الدليل / الملعب / jetski
● مجتمع hyprmcp ⚡ فوري

jetski

بواسطة hyprmcp · hyprmcp/jetski

أضف OAuth والسجلات الفورية وتحليلات الطلبات إلى أي خادم MCP دون تعديل الرمز — مع إرشادات إعداد عميل تُنشأ تلقائياً.

Jetski (hyprmcp) هي بوابة MCP توضع أمام خوادم MCP الخاصة بك، مضيفة مصادقة OAuth 2.1 + DCR، وتحليلات الطلبات والأدوات، والسجلات الفورية. تولّد تلقائياً تعليمات الإعداد لـ Claude و Cursor و VS Code. مكتوبة بـ Go مع لوحة تحكم Angular تدعمها Postgres وتنسيق Kubernetes.

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

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

عرض مباشر

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

jetski.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

claude mcp add jetski -- npx -y jetski

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

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

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

إضافة مصادقة OAuth إلى خادم MCP لا يدعمها

👤 فرق المنصات التي تنشر خدمات MCP لمستخدمين خارجيين ⏱ ~60 min advanced

متى تستخدمه: تطبيق MCP يعمل ممتازاً محلياً، لكن الخادم الأصلي لا يدعم المصادقة؛ تحتاج إلى التحقق من الهوية قبل فتحه للمستخدمين

المتطلبات الأساسية
  • مجموعة Kubernetes (أو k3s/minikube للتطوير) — Jetski تستخدم Metacontroller + CRDs
  • PostgreSQL — أي خادم Postgres يمكن الوصول إليه؛ ستنشئ Jetski المخطط المطلوب تلقائياً
الخطوات
  1. نشر Jetski
    طبّق chart Helm الخاص بـ Jetski على مجموعتي؛ تأكد من أن جميع وحدات pods جاهزة.✓ تم النسخ
    → البوابة ولوحة التحكم نشطة
  2. سجل خادم MCP الأصلي
    سجل خادم MCP الداخلي الخاص بي في svc.internal:9000 خلف Jetski مع المصادقة المطلوبة.✓ تم النسخ
    → عنوان URL البوابة الخاص بـ Jetski
  3. شارك رابط الإعداد
    أعطني مقتطف إعدادات Claude Desktop جاهزاً للنسخ واللصق لهذه البوابة.✓ تم النسخ
    → مقتطف إعدادات يعمل

النتيجة: خادم MCP مصرح له لكل مستخدم دون تعديل رمز الخادم الأصلي

المزالق
  • سوء إعداد Dex OIDC يترك المستخدمين في حلقة إعادة توجيه — تحقق من أن عنوان URL المُصدِّر يطابق ما يراه العملاء خارجياً (وليس DNS المجموعة الداخلية)
  • DCR تنشئ الكثير من العملاء اليتامى بمرور الوقت — قم بتنظيف العملاء القدماء بشكل دوري؛ Dex تدعم TTL
اجمعها مع: agent · proxy-2

شاهد بالضبط أي طلب أطلق أي أداة

👤 مؤلفو MCP ومهندسو الطلبات ⏱ ~30 min intermediate

متى تستخدمه: يبلغ المستخدمون 'لا يعمل' ولا تملك رؤية في ما يقولونه

الخطوات
  1. افتح التحليلات
    أظهر لي أفضل 10 طلبات اليوم واستدعاءات الأدوات التي أطلقتها.✓ تم النسخ
    → تفصيل من الطلب إلى الأداة
  2. ابحث عن نمط الفشل
    صفّي حسب استدعاءات الأدوات التي أرجعت أخطاء. ما النمط المشترك للطلبات؟✓ تم النسخ
    → مجموعات الأخطاء
  3. حسّن وصف الأداة
    اقترح تعديلاً على وصف الأداة يوجه الطلبات الغامضة إلى الأداة الصحيحة.✓ تم النسخ
    → تغيير ملموس

النتيجة: تحسينات مدفوعة بالبيانات على سطح أداتك

أضف زميلك بنقرة واحدة

👤 قادة الفريق الذين يضيفون أشخاصاً إلى أدوات MCP ⏱ ~10 min beginner

متى تستخدمه: أعددت بوابة ولا تريد كتابة وثائق الإعداد

الخطوات
  1. إنشاء الإعداد
    أعط زميلتك Alice عنوان URL إعداد بنقرة واحدة للبوابة.✓ تم النسخ
    → عنوان URL قابل للمشاركة مع تعليمات لكل عميل
  2. تحقق
    أكد ظهور Alice في تحليلات اليوم وتوفير الرموز الخاصة بها.✓ تم النسخ
    → Alice مرئية، الأدوات قابلة للاستدعاء

النتيجة: إعداد بدون وثائق

التركيبات

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

jetski + agent

1mcp/agent تجميع؛ Jetski تضيف التحليلات فوقها

ضع 1mcp/agent خلف Jetski حتى نحصل على التجميع + OAuth + التحليلات في مكدس واحد.✓ تم النسخ
jetski + vurb-ts

بناء مع Vurb، تشغيل خلف Jetski

نشر خادم MCP المبني بـ Vurb خلف Jetski للمصادقة والمراقبة دون تغييرات الرمز.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
(gateway) All upstream MCP tools pass through with OAuth أي استدعاء أداة عبر Jetski 1 upstream call
admin_register_upstream name, url, auth_required إضافة خادم أصلي جديد (للمسؤولين فقط) free

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

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

حصة API
بلا حد — يمر من خلالها
الرموز لكل استدعاء
حد أدنى من التكاليف العامة للبوابة
التكلفة المالية
مجاني، مفتوح المصدر
نصيحة
شغّل Postgres على نسخة مشتركة صغيرة؛ السجلات والتحليلات هي تكلفة التخزين الرئيسية.

الأمان

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

الحد الأدنى من الصلاحيات: إعداد OAuth في IdP الخاص بك
تخزين بيانات الاعتماد: مدفوع بالبيئة؛ Postgres يحتفظ بالجلسات + تسجيلات العميل
نقل البيانات الخارجي: استدعاءات MCP الأصلية؛ OIDC إلى IdP المُعد الخاص بك
لا تمنح أبدًا: نطاق admin للمستخدمين النهائيين

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

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

عدم تطابق مُصدِّر OIDC

يجب أن يطابق عنوان URL المُصدِّر في Dex ما يراه العملاء خارجياً، وليس DNS المجموعة الداخلية.

تحقق: curl /.well-known/openid-configuration من الخارج
لوحة تحكم التحليلات فارغة

تأكد من أن البوابة تقف أمام طلب واحد على الأقل؛ لوحة التحكم تتحدث في الوقت الفعلي تقريباً.

تحقق: قم باستدعاء أداة اختبار وأعد تحميل الصفحة
أخطاء الاتصال بـ PG

تحقق من متغير البيئة DATABASE_URL والسياسة الشبكية التي تسمح للبوابة بالوصول إلى PG.

تحقق: kubectl exec إلى pod البوابة و psql عنوان URL

البدائل

jetski مقابل البدائل

البديلمتى تستخدمهاالمقايضة
1mcp/agentتريد OAuth + التجميع بدون K8sلا توجد لوحة تحكم تحليلات مدعومة بـ Postgres
tbxark/mcp-proxyبسيطة؛ تجميع فقط، بدون مصادقةلا مصادقة، لا تحليلات
بناء خاصتك مع Kong/Envoyلديك بالفعل ثقافة service-meshعمل مخصص كبير لتوجيه خاص بـ MCP

المزيد

الموارد

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

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

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