MCP Dust Server

🚀 MCP 灰塵服務器配置指南

MCP 灰塵服務器是一個用於連接 Dust 代理的橋樑，藉助它，你能將 Dust 代理集成到各類開發環境中，充分發揮其強大功能。

🚀 快速開始

MCP 灰塵服務器可作為與 Dust 代理通信的橋樑。通過合理配置，你可以將 Dust 代理集成到不同的開發環境中，從而利用其強大的功能。

✨ 主要特性

• 作為橋樑實現與 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 Inspector 或其他客戶端的連接問題，請檢查以下內容：

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 許可證。