volcano-agent-sdk MCP — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

100+ LLM models across major providers
Automatic tool selection from multiple MCP endpoints
Multi-agent crews with task delegation
Parallel / branching / loop execution patterns
OpenTelemetry traces, native OAuth for MCPs, connection pooling

Живое демо

Как выглядит на практике

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 использует массив объектов серверов, а не map.

~/.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

Build a coding agent that uses GitHub + Sentry MCPs

👤 TS devs building internal automation ⏱ ~60 min advanced

Когда использовать: You want a programmable agent, not a chat session.

Предварительные требования

Node 20+ — Standard
MCP endpoints for the tools you want (github, sentry, etc.) — Either existing public or your own deploys

Поток

Install + scaffold

npm install @volcano.dev/agent and write a minimal agent that connects to github + sentry MCPs with Anthropic as the model.✓ Скопировано

→ Running TS project
Write the task

The agent's task: every 15 min, find new Sentry errors, correlate to GitHub commits via MCP, draft revert PRs for the obvious ones.✓ Скопировано

→ Agent executes task autonomously
Instrument

Enable OTel traces and pipe to Honeycomb/Grafana.✓ Скопировано

→ Spans visible

Итог: A production-ready automation agent with observability.

Подводные камни

Agent hallucinates tool calls that don't exist — Restrict the MCP set passed to the agent; fewer, well-documented tools > more
Retries amplify transient upstream issues — Tune retry policy and add exponential backoff

Сочетать с: github · sentry

Compose a multi-agent crew for research tasks

👤 Developers exploring agent patterns ⏱ ~45 min advanced

Когда использовать: A task benefits from specialization (researcher + writer + reviewer).

Поток

Define agents

Create agents: Researcher (web search MCP), Writer (drafts), Reviewer (fact-checks Researcher's sources).✓ Скопировано

→ Three typed agent instances
Delegate

Run the crew: topic 'state of MCP in 2026'. Have Researcher gather, Writer draft, Reviewer verify claims.✓ Скопировано

→ Coordinated output

Итог: Higher-quality output than a single-pass agent on complex tasks.

Сочетать с: omnisearch

Build a streaming chatbot with tool access

👤 Product devs integrating AI into a TS app ⏱ ~40 min advanced

Когда использовать: User-facing feature that needs real-time streaming + MCP tool calls.

Поток

Wire streaming

Build a chat endpoint that streams tokens to the client and calls tools mid-stream as the model requests.✓ Скопировано

→ Working streaming endpoint
Explainability

After each response, expose agent.summary() so the UI can show which tools were used.✓ Скопировано

→ Tool trail visible

Итог: A production chat UI with transparent tool use.

Комбинации

Сочетайте с другими MCP — эффект x10

volcano-agent-sdk + github + sentry

Autonomous triage agent across incident + code

Build an agent that, given a Sentry alert, fetches the stack, finds the offending commit via GitHub, and opens a PR with a minimal fix.✓ Скопировано

volcano-agent-sdk + vurb-ts

Vurb builds the server side; Volcano builds the agent side

Expose my business data via a Vurb MCP; build a Volcano agent that uses it to answer user questions.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
(SDK)	You write TS; SDK picks tools from configured MCPs automatically	N/A — Volcano Agent SDK is a library you build with, not an MCP server you call	n/a — depends on model + tools

Стоимость и лимиты

Во что обходится

Квота API: LLM provider limits apply; MCP upstream limits apply
Токенов на вызов: Depends on model + conversation length
Деньги: SDK free; LLM usage billed by provider
Совет: Use cheaper models (Haiku/GPT-4o-mini) for routing and reserve expensive models for reasoning; Volcano supports per-step model choice.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: LLM provider keys + MCP credentials in env; SDK injects them

Исходящий трафик: LLM provider APIs + configured MCP endpoints

Никогда не давайте: LLM keys to untrusted code paths in the same process

Auto tool selection means the agent can call anything you give it — scope MCP surface narrowly.
OTel traces may include prompt/response content — review before exporting to third-party APM.

Устранение неполадок

Частые ошибки и исправления

MCP connection fails on startup

Verify the MCP endpoint URL and auth. SDK logs full error when --debug is set.

Проверить: Curl the MCP endpoint directly

Model refuses to use available tools

Tool descriptions may be poorly phrased; rewrite for clarity or force via agent config.

Проверить: Inspect tools via agent.listTools()

High token cost on simple tasks

Check that system prompt isn't dragging MCP tool defs into every call; use lazy tool-load mode.

Проверить: agent.summary() shows token breakdown

Альтернативы

volcano-agent-sdk в сравнении

Альтернатива	Когда использовать	Компромисс
LangChain / LangGraph (TS)	You want the largest ecosystem of integrations	Heavier abstraction; slower cold path
Vercel AI SDK	You want tight Next.js integration	Less focus on multi-agent patterns
Anthropic SDK raw	You only need Anthropic and minimal abstraction	You reimplement tool routing, retries, multi-provider

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills