MCP Dust Server
Overview
基本能力
产品定位
MCP Dust Server 是一个用于与 Dust 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)
- 用于监控和健康检查的状态端点
适用场景
- 开发 AI 代理
- 自动化任务和工作流
- 企业生产力工具
- 数据分析和查询
- 多代理协作系统
工具列表
- MCP Server (server.ts): 处理与 Dust API 的 MCP 协议交互，管理会话状态和上下文，实现完整的 MCP 生命周期。
- MCP Test Client (client.ts): 提供 Web 界面进行测试，支持实时流式传输和调试。
常见问题解答
- 详细调试信息请参考开发者文档
- 连接问题可检查心跳机制和自动重连功能
- API 密钥和敏感信息在日志中被自动屏蔽
使用教程
使用依赖
- Node.js (推荐使用最新 LTS 版本，通过 nvm 安装)
- 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 # Startup Mode (server, client, or both) START_MODE=both
# MCP Server Configuration MCP_NAME=Dust MCP Server JS MCP_HOST=127.0.0.1 MCP_PORT=5001 MCP_TIMEOUT=30 # seconds
# MCP Test Client Configuration CLIENT_HOST=127.0.0.1 CLIENT_PORT=6001
# Dust API Configuration 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
# User Context Information (used in Dust API requests) DUST_USERNAME=your_username [email protected] DUST_FULLNAME=Your Full Name DUST_TIMEZONE=Europe/Berlin ```
调试方式
-
启动服务器和客户端:
bash npm run start -
仅启动 MCP 服务器:
bash npm run start:server -
仅启动测试客户端:
bash npm run start:client
预期输出:
- MCP 服务器: MCP Server running on http://127.0.0.1:5001 (timeout: 30s)
- 测试客户端: MCP Test Client running on http://127.0.0.1:6001