MCP Server Dust

🚀 MCP サーバードキュメント

MCP（Mission Control Protocol、任務制御プロトコル）サーバーは、Dust.tt API とやり取りするためのツールです。Claude モデルを代理して会話を行うことができます。このドキュメントでは、このサーバーの設定方法と使用方法を詳しく説明します。

🚀 クイックスタート

このセクションでは、MCP サーバーのクイックスタートについて説明します。

✨ 主な機能

• MCP サーバーは、Dust.tt API とのやり取りを可能にします。
• Claude モデルを代理して会話を行うことができます。

📦 インストール

クイックインストール

1. コードリポジトリをクローンします：

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

2. 依存関係をインストールします：

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"}'

応答例：

{"conversation": {"sId": "test-id", "title": "テスト会話", "created_at": 1742923287427}}

メッセージの送信

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"}}'

応答例：

{"message": {"sId": "msg-id-123", "content": "こんにちは！私はテストユーザーです。", "timestamp": 1742923287627}}

メッセージの検索

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

応答例：

[
  {"message_id": "msg-id-123", "content": "こんにちは！私はテストユーザーです。", "timestamp": 1742923287627},
  {"message_id": "msg-id-456", "content": "こんにちは！私は代理モデルです。", "timestamp": 1742923287630}
]

📚 ドキュメント

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