MCP Dust Server
Overview
基本能力
产品定位
MCP Dust Server 是一个用于与 Dust AI 代理交互的中间件服务器，旨在简化 AI 代理的集成和使用。
核心功能
- 分离的 MCP 服务器和测试客户端组件
- 通过 Dust API 与 AI 代理交互
- 使用 Server-Sent Events (SSE) 和 HTTP Stream Transport 实现实时流式响应
- 完整的 JSON-RPC 2.0 支持，包括 'initialize', 'message', 'terminate', 和 'run' 方法
- 通过 'run' 方法直接执行工具，简化客户端集成
- 强大的会话管理和上下文保存
- 安全的 API 密钥处理，日志中 PII 掩码
- 心跳机制维护持久连接
- 自动重连断开的连接
- 全面的错误处理和报告
- 支持最新的 MCP 规范 (2025-03-26)
- 状态端点用于监控和健康检查
适用场景
- 与 Dust AI 代理集成的开发项目
- 需要实时流式响应的应用
- 多代理工作流管理
- 企业级 AI 代理部署
工具列表
- MCP Server (server.ts): 处理与 Dust API 的 MCP 协议交互，管理会话状态和上下文。
- MCP Test Client (client.ts): 提供 Web 界面用于测试，支持实时流式调试和会话管理。
常见问题解答
- 详细调试信息请参考开发者文档
- 集成问题请检查环境变量配置
- 连接问题请检查心跳和自动重连机制
使用教程
使用依赖
- Node.js (推荐: 通过 nvm 安装最新 LTS 版本)
- npm (随 Node.js 一起安装)
- TypeScript
安装教程
-
克隆仓库:
bash git clone https://github.com/ma3u/mcp-dust-server.git cd mcp-dust-server -
安装依赖:
bash npm install -
配置环境变量: 在根目录创建
.env文件，基于.env.example:env START_MODE=both MCP_NAME=Dust MCP Server JS MCP_HOST=127.0.0.1 MCP_PORT=5001 MCP_TIMEOUT=30 CLIENT_HOST=127.0.0.1 CLIENT_PORT=6001 DUST_API_KEY=your_dust_api_key_here DUST_WORKSPACE_ID=your_workspace_id_here DUST_AGENT_ID=your_agent_id_here DUST_DOMAIN=https://dust.tt DUST_USERNAME=your_username [email protected] DUST_FULLNAME=Your Full Name DUST_TIMEZONE=Europe/Berlin
调试方式
-
开发模式启动服务器和客户端:
bash npm run dev -
仅启动 MCP 服务器:
bash npm run dev:server -
仅启动测试客户端:
bash npm run dev:client
生产模式命令将 dev 替换为 start。