/ الدليل / الملعب / vurb.ts
● مجتمع vinkius-labs ⚡ فوري

vurb.ts

بواسطة vinkius-labs · vinkius-labs/vurb.ts

إطار عمل TypeScript لبناء خوادم MCP ذات أدوات آمنة من الناحية النوعية، مع إزالة بيانات PII، وبوابات حالة FSM — فكر فيه بوصفه Express.js للـ MCP.

Vurb.ts ليس خادم MCP بل إطار عمل. موجه للمطورين الذين يبنون خوادم MCP خاصة بهم. يأتي مع طبقة عرض تزيل الأعمدة غير المُعلّنة من قاعدة البيانات، وإزالة PII في مرحلة 'Late Guillotine' (بعد المنطق، قبل الـ LLM)، وبوابات حالة FSM تمنع استدعاءات الأدوات من التنفيذ بترتيب غير صحيح، وواجهة سطر أوامر لتوليد الهياكل الأساسية تدعم Prisma و n8n و OpenAPI.

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

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

عرض مباشر

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

vurb-ts.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

claude mcp add vurb-ts -- npx -y vurb.ts

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

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

استخدامات عملية: vurb.ts

كيفية بناء خادم MCP آمن من بيانات PII باستخدام Vurb.ts

👤 المطورون الذين يبنون MCP لمنتج يحتوي على بيانات العملاء ⏱ ~60 min advanced

متى تستخدمه: عندما تقوم بتغليف نظام داخلي ويجب أن تضمن عدم مغادرة بيانات PII للمحيط.

المتطلبات الأساسية
  • Node 20+ و npm — قياسي
  • واجهة سطر أوامر Vurb — npm install -g @vurb/cli
الخطوات
  1. توليد الهيكل الأساسي
    قم بتشغيل vurb create customer-mcp باستخدام متجه prisma، وافتح مجلد src/tools/ الذي تم إنشاؤه.✓ تم النسخ
    → تم توليد المشروع
  2. تعريف عرض
    أضف عرضاً لنموذج Customer يعرض فقط id و plan و country. كل شيء آخر (البريد الإلكتروني والهاتف والعنوان) يُحذف فعلياً.✓ تم النسخ
    → يرى الـ LLM فقط الحقول المُعلّنة
  3. إضافة إزالة بيانات PII للحقول النصية الحرة
    على حقل body في نموذج Note، طبّق .redactPII() في Late Guillotine.✓ تم النسخ
    → رسائل البريد الإلكتروني والهواتف داخل أجسام الملاحظات مخفية
  4. الاختبار باستخدام خط الأنابيب في الذاكرة
    اكتب حالة اختبار @vurb/testing تغذي سجلاً يحتوي على بيانات PII مزيفة وتؤكد أن المخرجات مخفية.✓ تم النسخ
    → يمر الاختبار

النتيجة: خادم MCP حيث يكون تسرب بيانات PII استحالة من حيث التجميع/وقت التشغيل، وليس عنصر مراجعة الكود.

المزالق
  • regex الإزالة لا تمسك بكل شيء أبداً — اجمع قائمة العرض البيضاء + الإزالة — لا تعتمد على الإزالة وحدها
  • انجراف العرض بمرور الوقت — تأكيد CI: لقطة من مخرجات العرض للنماذج الرئيسية؛ اطلب من PRs الفشل التي تغيره بدون مراجعة

فرض الترتيب الصحيح لاستدعاء الأداة باستخدام بوابات حالة FSM

👤 مؤلفو MCP الذين يبنون تدفقات متعددة الخطوات (الحجز والدفع) ⏱ ~30 min intermediate

متى تستخدمه: عندما تكون لديك أدوات يجب أن تعمل بترتيب معين؛ تريد من الإطار أن يفرضها.

الخطوات
  1. تحديد آلة الحالة
    أنشئ FSM للدفع: cart → quote → payment → confirm. كل أداة محمية بالحالة.✓ تم النسخ
    → ملف تعريف آلة الحالة
  2. إرفاق البوابات بالأدوات
    أداة confirm_order مسموحة فقط من state=payment.✓ تم النسخ
    → استدعاء خارج الترتيب يعيد خطأ بوابة

النتيجة: لا يمكن للعملاء تخطي الخطوات الأساسية فعلياً.

نشر Vurb MCP إلى Cloudflare Workers أو Vinkius Edge

👤 المنشئون الذين يريدون MCPs بزمن تأخير منخفض عالمياً ⏱ ~20 min intermediate

متى تستخدمه: تريد أن يكون MCP قريباً من المستخدمين، وليس في منطقة واحدة.

الخطوات
  1. اختر الهدف
    vurb deploy --target cloudflare✓ تم النسخ
    → تم نشر Worker
  2. اختبار سريع
    قائمة الأدوات عبر عنوان URL المنشور.✓ تم النسخ
    → قائمة الأدوات تعود من CF

النتيجة: خادم MCP موزع عالمياً.

التركيبات

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

vurb-ts + jetski

بناء باستخدام Vurb؛ التشغيل خلف Jetski للتحقق من صحة OAuth والتحليلات

توليد Vurb MCP ونشره خلف Jetski بحيث يتحقق المستخدمون من صحتهم عبر OAuth ونحصل على تحليلات الـ prompt.✓ تم النسخ
vurb-ts + proxy-2

دمج Vurb MCP الخاص بك جنباً إلى جنب مع MCPs من طرف ثالث عبر mcp-proxy

تسجيل الـ Vurb MCP المنشور كمنبع لـ mcp-proxy بحيث يرى الزملاء جنباً إلى جنب مع github/sentry.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
(framework) تكتب الأدوات؛ الإطار يعرضها لا ينطبق — Vurb.ts موجود لتأليف خوادم MCP، وليس خادم MCP للاستدعاء لا ينطبق

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

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

حصة API
الإطار نفسه ليس له تكلفة وقت التشغيل؛ تعتمد تكاليف الاستضافة على هدف النشر
الرموز لكل استدعاء
يختلف بناءً على الأدوات التي تبنيها
التكلفة المالية
مجاني، مفتوح المصدر
نصيحة
النشر على الحافة رخيص (الطبقة المجانية CF Workers تتعامل مع حركة المرور المعتدلة).

الأمان

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

تخزين بيانات الاعتماد: أي شيء تحتاجه أدواتك المنشورة؛ يوفر الإطار hooks middleware للحقن
نقل البيانات الخارجي: يعتمد بالكامل على الأدوات التي تكتبها

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

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

تم إضافة ملف الأداة ولكنه لا يظهر

موجه قائم على الملفات يراقب src/tools/؛ أعد تشغيل خادم التطوير أو تحقق من نمط التصدير.

تحقق: vurb dev logs
العرض يزيل الكثير

تأكد من أن حقول العرض تطابق المخطط؛ أعد إضافة الحقول المفقودة بشكل صريح.

تحقق: Unit test presenter output
خطأ بوابة الحالة على استدعاء صحيح

تحقق من انتقالات FSM — قد لا تطابق الحالة المصدر. اطبع الحالة الحالية في middleware.

تحقق: Add a log in state middleware

البدائل

vurb.ts مقابل البدائل

البديلمتى تستخدمهاالمقايضة
FastMCP (TypeScript)تريد الحد الأدنى من boilerplate، بدون حراس رأيلا توجد ميزات PII/FSM — تثبتها بنفسك
@modelcontextprotocol/sdkتريد التحكم في البروتوكول الخامأحضر المصادقة والإزالة والاختبارات الخاصة بك
volcano-agent-sdkأنت تبني وكلاء يستهلكون MCPs، وليس الخوادمدور مختلف في المكدس

المزيد

الموارد

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

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

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