What is the Dust MCP Server?

The Dust MCP (Model Context Protocol) Server is a TypeScript-based server that bridges Dust.tt agents with external tools via JSON-RPC, SSE, and secure API integration. It is designed for seamless integration with Claude Desktop and implements MCP specifications/SDK.

What are the prerequisites for running the Dust MCP Server?

The prerequisites include Node.js v18 or later, npm 9.x or later, a Dust.tt account with API access, and a Redis server for session management.

How do I install the Dust MCP Server?

To install the Dust MCP Server, clone the repository, install dependencies using npm install, set up the environment variables, build the project using npm run build, and then start the server.

What environment variables do I need to configure?

Required environment variables include DUST_API_KEY and DUST_WORKSPACE_ID. Optional variables include PORT, NODE_ENV, LOG_LEVEL, DUST_AGENT_IDS, MAX_SESSIONS, and SESSION_TIMEOUT.

How do I integrate the Dust MCP Server with Claude Desktop?

First, install MCP Tools globally using npm install -g @modelcontextprotocol/tools. Then, configure Claude Desktop to use your MCP server with mcp configs set claude-desktop dust $(which node) $(pwd)/build/dust.js. Finally, restart Claude Desktop.

What is the Memory Bank system?

The Memory Bank system provides persistent storage for agent state and configuration, including active context, decision logs, progress tracking, system patterns, and product context.

How do I run tests for the Dust MCP Server?

You can run tests using the following npm scripts: npm test for all tests, npm run test:unit for unit tests, npm run test:integration for integration tests, and npm run test:e2e for end-to-end tests.

What is STDIO mode, and how do I use it?

STDIO mode is used for communication through standard input/output streams rather than HTTP. It is used by Claude Desktop and other MCP clients. To start the server in STDIO mode, use the command node build/dust.js.

How do I configure Redis for session management?

Set the following environment variables in your .env file: REDIS_URL, REDIS_PASSWORD, REDIS_TLS, SESSION_SECRET, and SESSION_TTL. You can test the Redis connection with the provided Node.js script.

What are the key components of the Dust MCP Server architecture?

Key components include the Client Layer (e.g., Claude Desktop), the MCP Server with its request handler, auth middleware, tool router, MCP tools, core services (DustApiService, AgentService, SessionManager, MemoryBank), and external services like the Dust AI Platform.