使用说明

项目简介

Dust Bridge Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在连接开发工具（如 Windsurf IDE 和 Claude Desktop）与 Dust.tt AI 助手。通过该服务器，用户可以直接在开发环境中使用配置的 Dust AI 智能体，实现代码编写、问题解答等 AI 辅助功能。

主要功能点

连接 Dust.tt 工作区和智能体: 允许开发工具连接到用户的 Dust.tt 账户和指定的 AI 智能体。
查询 Dust 智能体: 支持从 Windsurf 或 Claude Desktop 等客户端直接向 Dust 智能体发送查询请求。
流式传输响应: 将 Dust 智能体的响应流式传输回开发工具，实现实时的交互体验。
错误处理: 提供优雅的错误处理机制，提升系统的健壮性。
提供 echo 工具: 用于测试 MCP 服务器连接是否正常。
提供 dust-query 工具: 用于向配置的 Dust AI 智能体发送查询请求。

安装步骤

克隆仓库:

git clone https://github.com/Ma3u/mcp-dust-server.git
cd mcp-dust-server

安装依赖:
```
npm install
```
配置环境变量:
- 复制 '.env.example' 文件并重命名为 '.env'。
- 根据 '.env' 文件中的注释，配置 Dust API 密钥 (DUST_API_KEY)、工作区 ID (DUST_WORKSPACE_ID)、智能体 ID (DUST_AGENT_ID) 等信息，以及 MCP 服务器自身的端口、名称等配置。

服务器配置

对于 MCP 客户端（如 Windsurf IDE、Claude Desktop），需要配置连接到 Dust Bridge Server 的信息。以下是配置示例（JSON 格式）：

{
  "server name": "Dust Bridge",
  "command": "npx ts-node",
  "args": [
    "/path/to/mcp-dust-server/src/server.ts"
  ],
  "protocol": "stdio",
  "host": "localhost",
  "port": 5001
}

配置参数说明:

'server name': 自定义的 MCP 服务器名称，例如 "Dust Bridge"。
'command': 启动 MCP 服务器的命令，通常为 'npx ts-node'。
'args': 启动命令的参数，指向 'src/server.ts' 脚本的绝对路径。请将 '/path/to/mcp-dust-server' 替换为实际仓库的路径。
'protocol': 连接协议，这里使用 'stdio'。
'host': MCP 服务器主机地址，默认为 'localhost' 或 '127.0.0.1'。
'port': MCP 服务器端口号，默认为 '5001'，需与 '.env' 文件中 'MCP_PORT' 配置一致。

注意: 请根据实际的 MCP 客户端配置界面填写上述信息。'/path/to/mcp-dust-server/src/server.ts' 需要替换为 'server.ts' 文件在您本地文件系统中的绝对路径。

基本使用方法

启动 Dust Bridge Server: 在仓库目录下，运行命令 'npx ts-node src/server.ts' 启动服务器。
在 MCP 客户端中使用:
- 打开 Windsurf IDE 或 Claude Desktop 等 MCP 客户端。
- 在 MCP 设置中，添加或选择已配置的 "Dust Bridge" 服务器。
- 在工具面板或相应的功能入口，选择 'dust-query' 工具。
- 在查询输入框中，输入您的问题或请求。
- 点击 "运行" 或 "提交" 等按钮，将查询发送到 Dust AI 智能体。
- 查看客户端输出面板或聊天界面，获取 Dust 智能体的响应。
- 您还可以使用 'echo' 工具测试服务器连接。

关键词