MCP Server Dust

🚀 MCP 服务器文档

MCP（Mission Control Protocol，任务控制协议）服务器是一款用于与 Dust.tt API 交互的工具，借助代理 Claude 模型实现对话功能。本详细文档将指导你完成服务器的配置与使用。

🚀 快速开始

MCP 服务器可帮助你通过代理 Claude 模型与 Dust.tt API 进行交互。下面为你介绍如何安装、配置和启动该服务器。

📦 安装指南

快速安装

首先，克隆代码仓库并安装所需依赖项：

git clone git@github.com:your-repository.git
pip install -r requirements.txt

配置

创建配置文件config.json，并按如下内容进行替换：

{
  "workspace_id": "{WORKSPACE_ID}", // 替换为你的工作区 ID
  "api_key": "{YOUR_API_KEY}",     // 替换为你的 API 密钥
  "agent_id": "{AGENT_ID}",        // 替换为你的代理 ID
  "model_settings": {
    "provider": "anthropic",
    "model": "claude-3-sonnet"
  }
}

启动服务器

使用以下命令启动 MCP 服务器：

python mcp_server.py --config config.json

💻 使用示例

基础用法

以下是一个完整的对话流程示例，展示如何创建对话、发送消息和检索消息：

# 创建对话
curl -X POST "http://localhost:8000/api/conversations" \
  -H "Content-Type: application/json" \
  -d '{"title": "测试对话", "model": "claude-3-5-sonnet-20240620"}'

# 发送消息
curl -X POST "http://localhost:8000/api/conversations/test-id/messages" \
  -H "Content-Type: application/json" \
  -d '{"content": "你好！我是测试用户。", "mentions": [{"configurationId": "{AGENT_ID}", "context": {"时区": "Europe/Berlin", "modelSettings": {"provider": "anthropic"}}]}, "context": {"时区": "Europe/Berlin"}}'

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

📚 详细文档

API 接口

创建对话

发送 POST 请求以创建新对话：

curl -X POST "http://localhost:8000/api/conversations" \
  -H "Content-Type: application/json" \
  -d '{"title": "系统思维对话", "model": "claude-3-5-sonnet-20240620"}'

响应示例：

{
  "conversation": {
    "sId": "DhvpbhW74S",
    "title": "系统思维对话",
    "created_at": 1742923287427
  }
}

发送消息

向指定对话发送用户消息：

curl -X POST "http://localhost:8000/api/conversations/{CONVERSATION_ID}/messages" \
  -H "Content-Type: application/json" \
  -d '{"content": "解释 MCP 协议的细节", "mentions": [{"configurationId": "{AGENT_ID}", "context": {"时区": "Europe/Berlin", "modelSettings": {"provider": "anthropic"}}]}, "context": {"时区": "Europe/Berlin"}}'

响应示例：

{
  "message": {
    "sId": "qwenj3rusI",
    "conversation_sId": "DhvpbhW74S",
    "content": "解释 MCP 协议的细节",
    "author_name": "用户",
    "author_type": "user",
    "created_at": 1742923287627
  }
}

检索消息

从指定对话中检索消息：

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

响应示例：

[
  {"message_id": "qwenj3rusI", "content": "解释 MCP 协议的细节", "timestamp": 1742923287627},
  {"message_id": "another-id", "content": "回复内容", "timestamp": 1742923287630}
]

错误处理

常见错误

• 400 Bad Request：请求格式无效。
• 401 Unauthorized：认证失败。
• 404 Not Found：对话或消息不存在。

日志记录

MCP 服务器支持日志记录功能，日志文件默认存储在logs/目录下，格式为YYYYMMDD.log。

👥 项目贡献

我们欢迎社区贡献代码和改进文档。请在 GitHub 仓库中提交拉取请求。

📞 联系方式

如有任何问题或反馈，请通过以下方式联系我们：

• 邮箱：contact@your-domain.com
• GitHub：github.com/your-repository