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