适合谁
- 已经熟悉 TypeScript、需要在自有应用中编排 LLM 与多个 MCP 服务器交互的后端/平台工程师
- 需要构建多智能体委派工作流（研究、写作、任务处理等分工协作）的团队
- 希望在同一工作流中混合调用多家 LLM 提供商并要求内置重试、流式输出与追踪能力的团队
V
38FMRS · D
Volcano Agent SDK 是一个面向 TypeScript 开发者的多提供商 AI 智能体编排框架，通过连接外部 MCP 服务器实现自动工具选择和多智能体协作，但它本身不是一个暴露工具的 MCP 服务器，且仓库未提供任何服务器清单或固定工具列表。
Volcano Agent SDK 是 Kong 推出的一个 TypeScript SDK，用于构建能够将大语言模型（LLM）推理与通过 MCP 工具执行的真实动作相结合的 AI 智能体。需要说明的是，该项目本身是一个客户端/编排框架，而不是一个暴露具体工具的 MCP 服务器——开发者通过 mcp(url) 连接到外部 MCP 服务器，让 LLM 自动挑选并调用其中的工具。它支持混合使用 OpenAI、Anthropic、Mistral 等多家模型提供商，并提供并行执行、分支、循环、多智能体协作（由协调者自动委派任务给专职智能体）、流式输出、OpenTelemetry 可观测性以及内置重试和超时处理等特性。仓库中没有提供任何服务器清单（manifest）或固定的工具列表，因为工具集完全取决于开发者接入的外部 MCP 服务器。
工具能力
暂未整理工具清单。
安装接入
通过 npm 安装：npm install @volcano.dev/agent。安装后在 TypeScript 代码中引入 agent、llmOpenAI（或其他提供商的辅助函数）以及 mcp，用你的 LLM API 密钥初始化模型，再用 mcp("http://host:port/mcp") 指向你已经运行的 MCP 服务器地址，然后编排 .then() 步骤并调用 .run()。该 SDK 本身不需要、也不提供 Claude Desktop 等客户端的 JSON 配置文件，因为它是嵌入到你自己 TypeScript 应用中的库，而不是一个独立运行的 MCP 服务器进程。
选型与风险
不适合谁
- 只想要一个开箱即用、暴露特定业务工具的 MCP 服务器的用户（本项目不提供任何具体工具，需自行接入外部 MCP 服务器）
- 使用 Python 或其他非 JavaScript/TypeScript 技术栈的开发者
- 希望通过 Claude Desktop 等客户端配置文件直接添加的非技术用户
所需权限
- 需要开发者提供的 LLM 提供商 API 密钥（如 OPENAI_API_KEY）以调用远程模型
- 需要网络访问权限以连接开发者自行部署的 MCP 服务器端点（如 http://localhost:8001/mcp）
- 由于支持自动工具选择，实际执行动作时会隐式获得所连接 MCP 服务器授予的一切工具权限
风险与副作用
- 自动工具选择意味着 LLM 会根据提示自行决定调用哪些工具，如果连接了具有真实副作用的 MCP 服务器（如创建任务、发送请求），存在因提示注入或模型误判而执行非预期操作的风险
- 多智能体委派模式下，协调者自主决定何时终止流程，若逻辑设计不当可能导致意外的重复调用或资源消耗
- README 未说明具体的认证、沙箱或权限隔离机制，接入的 MCP 服务器的安全边界需要开发者自行把控
常见排障
- 确认已正确设置所用 LLM 提供商的 API 密钥环境变量
- 确认 mcp() 中填写的服务器 URL 可达，且目标 MCP 服务器已启动并监听对应端口
- 查看官方文档站点 volcano.dev/docs 中关于 MCP 工具连接池、OAuth 认证等章节，排查工具未被正确选择或调用失败的问题
- 检查 npm 包版本 @volcano.dev/agent 是否为最新，或参考仓库 CI 状态确认没有已知的构建问题
使用场景
编排一个 LLM 智能体，根据自然语言提示自动选择并调用多个已部署的 MCP 服务器上的工具
构建多智能体协作流水线，由协调者智能体自动把任务委派给专职的子智能体（如研究员、写作者）
在生产环境中跨多个 LLM 提供商（OpenAI、Anthropic、Mistral 等）切换或混合使用，并接入 OpenTelemetry 做可观测性追踪
支持客户端
暂未确认支持的客户端。