MCP Server Dust

🚀 MCP Server Documentation

The MCP (Mission Control Protocol) server is a tool for interacting with the Dust.tt API, allowing conversations via the proxy Claude model. This document details how to configure and use the server.

🚀 Quick Start

The MCP server enables interaction with the Dust.tt API through the proxy Claude model. This guide will walk you through the installation, configuration, and usage of the server.

✨ Features

• Interact with the Dust.tt API.
• Conduct conversations via the proxy Claude model.

📦 Installation

Quick Installation

1. Clone the code repository:

git clone git@github.com:your-repository.git

2. Install dependencies:

pip install -r requirements.txt

Configuration

Create a configuration file config.json with the following content:

{
  "workspace_id": "{WORKSPACE_ID}", // Replace with your workspace ID
  "api_key": "{YOUR_API_KEY}",     // Replace with your API key
  "agent_id": "{AGENT_ID}",        // Replace with your agent ID
  "model_settings": {
    "provider": "anthropic",
    "model": "claude-3-sonnet"
  }
}

Start the Server

Run the following command to start the MCP server:

python mcp_server.py --config config.json

💻 Usage Examples

Basic Usage

Here is a complete example of a conversation flow:

1. Create a conversation:

curl -X POST "http://localhost:8000/api/conversations" \
  -H "Content-Type: application/json" \
  -d '{"title": "Test Conversation", "model": "claude-3-5-sonnet-20240620"}'

Response:

{"conversation": {"sId": "test-id", "title": "Test Conversation", "created_at": 1742923287427}}

2. Send a message:

curl -X POST "http://localhost:8000/api/conversations/test-id/messages" \
  -H "Content-Type: application/json" \
  -d '{"content": "Hello! I am a test user.", "mentions": [{"configurationId": "{AGENT_ID}", "context": {"timezone": "Europe/Berlin", "modelSettings": {"provider": "anthropic"}}]}, "context": {"timezone": "Europe/Berlin"}}'

Response:

{"message": {"sId": "msg-id-123", "content": "Hello! I am a test user.", "timestamp": 1742923287627}}

3. Retrieve messages:

curl -X GET "http://localhost:8000/api/conversations/test-id/messages" \
  -H "Content-Type: application/json"

Response:

[
  {"message_id": "msg-id-123", "content": "Hello! I am a test user.", "timestamp": 1742923287627},
  {"message_id": "msg-id-456", "content": "Hello! I am the proxy model.", "timestamp": 1742923287630}
]

📚 Documentation

API Interfaces

Create a Conversation

Send a POST request to create a new conversation:

curl -X POST "http://localhost:8000/api/conversations" \
  -H "Content-Type: application/json" \
  -d '{"title": "System Thinking Conversation", "model": "claude-3-5-sonnet-20240620"}'

Response example:

{
  "conversation": {
    "sId": "DhvpbhW74S",
    "title": "System Thinking Conversation",
    "created_at": 1742923287427
  }
}

Send a Message

Send a user message to a specified conversation:

curl -X POST "http://localhost:8000/api/conversations/{CONVERSATION_ID}/messages" \
  -H "Content-Type: application/json" \
  -d '{"content": "Explain the details of the MCP protocol", "mentions": [{"configurationId": "{AGENT_ID}", "context": {"timezone": "Europe/Berlin", "modelSettings": {"provider": "anthropic"}}]}, "context": {"timezone": "Europe/Berlin"}}'

Response example:

{
  "message": {
    "sId": "qwenj3rusI",
    "conversation_sId": "DhvpbhW74S",
    "content": "Explain the details of the MCP protocol",
    "author_name": "User",
    "author_type": "user",
    "created_at": 1742923287627
  }
}

Retrieve Messages

Retrieve messages from a specified conversation:

curl -X GET "http://localhost:8000/api/conversations/{CONVERSATION_ID}/messages" \
  -H "Content-Type: application/json"

Response example:

[
  {"message_id": "qwenj3rusI", "content": "Explain the details of the MCP protocol", "timestamp": 1742923287627},
  {"message_id": "another-id", "content": "Response content", "timestamp": 1742923287630}
]

Error Handling

Common Errors

• 400 Bad Request: Invalid request format.
• 401 Unauthorized: Authentication failed.
• 404 Not Found: Conversation or message does not exist.

Logging

The MCP server supports logging. Log files are stored in the logs/ directory by default, with the format YYYYMMDD.log.

🤝 Project Contribution

We welcome community contributions to the code and documentation. Please submit pull requests in the GitHub repository.

📞 Contact Information

If you have any questions or feedback, please contact us:

• Email: contact@your-domain.com
• GitHub: github.com/your-repository