MCP Dust Server

🚀 MCP ダストサーバー構成ガイド

MCP ダストサーバーは、Dust エージェントと通信するためのブリッジです。MCP サーバーを構成することで、Dust エージェントをさまざまな開発環境に統合し、その強力な機能を活用することができます。

🚀 クイックスタート

📦 インストール

.env ファイルの作成

プロジェクトのルートディレクトリに .env ファイルを作成し、以下の内容を記入します。

MCP_PORT=5001
MCP_MIN_PORT=5001
MCP_MAX_PORT=5001
DUST_API_KEY=your_api_key_here
DUST_WORKSPACE_ID=your_workspace_id_here
DUST_AGENT_ID=your_agent_id_here

your_api_key_here、your_workspace_id_here、your_agent_id_here を実際の API キーとエージェント情報に置き換えてください。

依存関係のインストール

プロジェクトディレクトリで以下のコマンドを実行して、すべての依存関係をインストールします。

npm install

サーバーとクライアントの起動

サーバーとクライアントを同時に起動

npm run start

MCP サーバーのみを起動

npm run start:server

テストクライアントのみを起動

npm run start:client

予想される出力

正しく構成されていれば、以下の出力が表示されます。

MCP サーバーの場合：

MCP サーバーは http://127.0.0.1:5001 で実行中です（タイムアウト時間：30s）
サーバー名：Dust MCP ブリッジ
Dust ワークスペース：your_workspace_id
Dust エージェント：your_agent_id

テストクライアントの場合：

MCP テストクライアントは http://127.0.0.1:6001 で実行中です

📚 ドキュメント

🔌 API エンドポイント

サーバーは、ヘルスチェックと MCP プロトコル通信のための複数のエンドポイントを提供しています。詳細なドキュメントについては、開発者ドキュメント を参照してください。

主なエンドポイントは以下の通りです。

• ヘルスチェック：/health、/ready、/live
• MCP プロトコル：/sse（サーバー送信イベント）、/stream（HTTP ストリーム転送）

🔍 デバッグ

詳細なデバッグツールと技術情報については、開発者ドキュメント を参照してください。

一般的な接続問題のトラブルシューティング

MCP インスペクターまたは他のクライアントとの接続問題が発生した場合は、以下の項目を確認してください。

1. MCP サーバーが実行中であることを確認します。
2. ファイアウォール設定を確認し、ポートがブロックされていないことを確認します。
3. コンソール出力を確認して、エラー情報を取得します。

🔗 統合ガイド

Windsurf IDE との統合

settings.json ファイルに以下の構成を追加します。

{
  "mcp-dust": {
    "serverUrl": "http://localhost:5001"
  }
}

Claude Desktop との統合

config.yml ファイルを編集し、以下の内容を追加します。

mcp:
  server_url: http://localhost:5001

🧪 テスト情報

コマンドラインまたはウェブインターフェイスを使用して、MCP サーバーの機能をテストすることができます。

📖 開発者ドキュメント

詳細な技術ドキュメントについては、開発者ドキュメント を参照してください。

📄 ライセンス

このプロジェクトは MIT ライセンスに準拠しています。