ma3u mcp dust server

WHAT IT CONNECTS

ma3u mcp dust server 为 AI Agent 提供什么

• Separate MCP server and test client components
• Interaction with Dust AI agents via the Dust API
• Real-time streaming responses using Server-Sent Events (SSE) and HTTP Stream Transport
• Full JSON-RPC 2.0 support with 'initialize', 'message', 'terminate', and 'run' methods
• Direct tool execution via the 'run' method for simplified client integration
• Robust session management and context preservation
• Secure API key handling with PII masking in logs
• Heartbeat mechanism to maintain persistent connections
• Automatic reconnection for dropped connections
• Comprehensive error handling and reporting
• Support for the latest MCP specification (2025-03-26)
• Status endpoints for monitoring and health checks
• **MCP Server (server.ts)**:
• Handles MCP protocol interactions with Dust API
• Manages session state and context
• Implements the full MCP lifecycle (initialize, message, terminate)
• Supports both SSE and HTTP Stream Transport
• Provides status endpoints for monitoring
• **MCP Test Client (client.ts)**:
• Provides a web interface for testing
• Allows interaction with the MCP server
• Supports real-time streaming and debugging
• Includes session management and connection tracking
• Node.js (recommended: latest LTS version installed via [nvm](https://github.com/nvm-sh/nvm))
• npm (comes with Node.js)
• TypeScript
• Clone the repository:
• Install dependencies:
• Configure environment variables:
• **Start both Server and Client**:
• **Start MCP Server only**:
• **Start Test Client only**:
• **Health Checks**: `/health`, `/ready`, `/live`
• **MCP Protocol**: `/sse` (Server-Sent Events), `/stream` (HTTP Stream Transport)
• **Port Configuration Mismatch**: Ensure your `.env` file has consistent port settings (MCP_PORT, MCP_MIN_PORT, MCP_MAX_PORT)
• **Transport Mode**: For Claude Desktop or MCP Inspector with stdio transport, set `TRANSPORT_MODE=stdio` in your `.env`
• **Multiple Response Headers**: If you see "ERR_HTTP_HEADERS_SENT" errors, check for middleware sending multiple responses