Cloud · MODEL CONTEXT PROTOCOL
ma3u mcp dust server
Model Context Protocol (MCP) bridge server for connecting to Dust.tt AI assistants (Depricated)
WHAT IT CONNECTS
What ma3u mcp dust server gives an 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
SECURITY
An MCP listing is not a security review
An MCP server may receive model context, credentials, local files, or permission to call external systems. Review its code, requested environment variables, network behavior, package provenance, and maintenance status before connecting it to an agent.