/ الدليل / الملعب / volcano-agent-sdk
← كل الخوادم ↗ GitHub
● مجتمع Kong ⚡ فوري

volcano-agent-sdk

بواسطة Kong · Kong/volcano-agent-sdk

بناء وكلاء AI من نوع TypeScript يربط بين استدلال LLM وأدوات MCP — 100+ نموذج، تنفيذ متوازي، تتبع OTel مدمج.

Volcano Agent SDK من Kong هو SDK من نوع TypeScript (وليس خادم MCP) لبناء وكلاء AI متعددي المزودين يستهلكون أدوات MCP. يدعم OpenAI و Anthropic و Mistral و Bedrock و Vertex و Azure. يختار الأدوات تلقائياً من نقاط نهاية MCP المكونة، ويرسل الرموز، وإعادة المحاولة عند الفشل، ويشحن آثار OpenTelemetry.

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

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

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

عرض مباشر

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

volcano-agent-sdk.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

claude mcp add volcano-agent-sdk -- npx -y volcano-agent-sdk

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

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

استخدامات عملية: volcano-agent-sdk

بناء وكيل ترميز يستخدم MCPs من GitHub و Sentry

👤 مطورو TS الذين يبنون أتمتة داخلية ⏱ ~60 min advanced

متى تستخدمه: تريد وكيلاً قابلاً للبرمجة، وليس جلسة دردشة.

المتطلبات الأساسية
  • Node 20+ — قياسي
  • نقاط نهاية MCP للأدوات التي تريدها (github, sentry, إلخ) — إما موجودة علناً أو نشرات خاصة بك
الخطوات
  1. تثبيت + السقالة
    npm install @volcano.dev/agent واكتب وكيلاً بسيطاً يتصل بـ github و sentry MCPs مع Anthropic كنموذج.✓ تم النسخ
    → مشروع TS قيد التشغيل
  2. اكتب المهمة
    مهمة الوكيل: كل 15 دقيقة، ابحث عن أخطاء Sentry جديدة، وربطها بـ GitHub commits عبر MCP، وصياغة PRs للعودة للواضحة منها.✓ تم النسخ
    → الوكيل ينفذ المهمة بشكل مستقل
  3. تجهيز الأدوات
    تفعيل آثار OTel وأنابيب إلى Honeycomb/Grafana.✓ تم النسخ
    → آثار مرئية

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

المزالق
  • الوكيل يتخيل استدعاءات أدوات غير موجودة — قيد مجموعة MCP التي يتم تمريرها للوكيل؛ عدد أقل من الأدوات الموثقة بشكل جيد أفضل
  • إعادة المحاولة تضخم المشاكل العابرة في المصب — ضبط سياسة إعادة المحاولة وإضافة تراجع أسي
اجمعها مع: github · sentry

قم بتكوين طاقم متعدد الوكلاء لمهام البحث

👤 المطورون الذين يستكشفون أنماط الوكلاء ⏱ ~45 min advanced

متى تستخدمه: تستفيد المهمة من التخصص (باحث + كاتب + مراجع).

الخطوات
  1. حدد الوكلاء
    إنشاء الوكلاء: Researcher (web search MCP)، Writer (المسودات)، Reviewer (التحقق من حقائق مصادر الباحث).✓ تم النسخ
    → ثلاث نسخ من الوكيل
  2. فوض
    قم بتشغيل الطاقم: موضوع 'حالة MCP في 2026'. اجعل الباحث يجمع، والكاتب يصيغ، والمراجع يتحقق من الادعاءات.✓ تم النسخ
    → مخرجات منسقة

النتيجة: مخرجات عالية الجودة أكثر من وكيل بمسار واحد في المهام المعقدة.

اجمعها مع: omnisearch

بناء روبوت محادثة متدفق مع الوصول إلى الأدوات

👤 مطورو المنتج الذين يدمجون AI في تطبيق TS ⏱ ~40 min advanced

متى تستخدمه: ميزة موجهة للمستخدم تتطلب بث فوري + استدعاءات أدوات MCP.

الخطوات
  1. ربط البث
    بناء نقطة نهاية دردشة تبث الرموز للعميل واستدعاء الأدوات أثناء البث كما يطلب النموذج.✓ تم النسخ
    → نقطة نهاية بث تعمل
  2. القابلية للشرح
    بعد كل استجابة، اكشف agent.summary() حتى تتمكن واجهة المستخدم من عرض الأدوات المستخدمة.✓ تم النسخ
    → أثر الأدوات مرئي

النتيجة: واجهة مستخدم دردشة إنتاجية مع استخدام أدوات شفاف.

التركيبات

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

volcano-agent-sdk + github + sentry

وكيل فحص تلقائي عبر الحادث + الكود

بناء وكيل يأخذ تنبيه Sentry، ويجلب المكدس، ويجد الـ commit المسيء عبر GitHub، ويفتح PR بإصلاح بسيط.✓ تم النسخ
volcano-agent-sdk + vurb-ts

Vurb تبني الجانب الخادم؛ Volcano تبني جانب الوكيل

اكشف بيانات عملي عبر Vurb MCP؛ بناء وكيل Volcano يستخدمها للإجابة على أسئلة المستخدم.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
(SDK) You write TS; SDK picks tools from configured MCPs automatically N/A — Volcano Agent SDK هي مكتبة تبني معها، وليست خادم MCP تستدعيه n/a — depends on model + tools

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

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

حصة API
حدود مزودي LLM تنطبق؛ حدود MCP المصب تنطبق
الرموز لكل استدعاء
يعتمد على النموذج + طول المحادثة
التكلفة المالية
SDK مجاني؛ استخدام LLM يتم فواتيره من قبل المزود
نصيحة
استخدم نماذج أرخص (Haiku/GPT-4o-mini) للتوجيه واحتفظ بالنماذج الغالية للاستدلال؛ Volcano يدعم اختيار النموذج لكل خطوة.

الأمان

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

تخزين بيانات الاعتماد: مفاتيح مزودي LLM + بيانات اعتماد MCP في البيئة؛ يحقنها SDK
نقل البيانات الخارجي: مزودي LLM APIs + نقاط نهاية MCP المكونة
لا تمنح أبدًا: منح مفاتيح LLM إلى مسارات الكود غير الموثوقة في نفس العملية

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

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

MCP connection fails on startup

تحقق من عنوان URL لنقطة نهاية MCP والمصادقة. SDK تسجل الخطأ الكامل عند تعيين --debug.

تحقق: استدعي نقطة نهاية MCP مباشرة
Model refuses to use available tools

قد تكون وصفات الأدوات غير واضحة؛ أعد صياغتها لوضوح أو فرضها عبر إعدادات الوكيل.

تحقق: فحص الأدوات عبر agent.listTools()
High token cost on simple tasks

تحقق من أن مطالب النظام لا تسحب تعريفات أدوات MCP إلى كل استدعاء؛ استخدم وضع تحميل الأدوات البطيء.

تحقق: agent.summary() يعرض توزيع الرموز

البدائل

volcano-agent-sdk مقابل البدائل

البديلمتى تستخدمهاالمقايضة
LangChain / LangGraph (TS)تريد أكبر نظام بيئي للتكاملاتتجريد أثقل؛ مسار بارد أبطأ
Vercel AI SDKتريد تكاملاً قريباً مع Next.jsتركيز أقل على أنماط الوكيل المتعدد
Anthropic SDK rawتحتاج فقط إلى Anthropic والتجريد البسيطتحتاج إلى إعادة تنفيذ توجيه الأدوات، وإعادة المحاولة، ومتعدد المزودين

المزيد

الموارد

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

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

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