Dust MCP Server (Ma3u)

MCP浏览器工具

提供方 ma3u

浏览器工具 stdio · 本地进程 Token 社区 / 第三方 Claude DesktopClaudeWindsurfVS Code
查看接入方式

Dust MCP Server是一个为Dust.tt代理设计的模型上下文协议服务器,提供代理查询、列表和配置工具,支持与Claude Desktop的无缝集成。

一句话选型结论

按资料字段整理

Dust MCP Server (Ma3u) 属于浏览器工具类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude Desktop、Claude、Windsurf 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类浏览器工具 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 7 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

浏览器工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

HTML本地部署代理管理会话管理多代理协作上下文共享Redis存储

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
docker run -p 3000:3000 --env-file .env dust-mcp-server

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
自动操作网页

打开页面、点击、填表,把浏览器动作交给模型执行。

抓取结构化数据

把页面内容整理成表格或 JSON,省掉手工复制粘贴。

关键流程回归

按步骤检查页面是否正常,回归时少漏环节。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Windsurf,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在浏览器工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Dust MCP Server (Ma3u)当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Playwright MCP Server 21 stdio · 本地进程 本地部署 有 2026-05-18
Fetch 9a2682de 1 SSE · 服务端推送 支持远程部署 有 2026-05-18
Browser 738d52bc 未标注 stdio · 本地进程 本地部署 有 2026-05-17
MCP 40600ece 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Skyvern MCP 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

浏览器工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方ma3u上游标注的维护方 ma3u
分类浏览器工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

24.1 KB
来自项目仓库与上游目录的原文,未做删改

灰尘MCP服务器

用于Dust.tt代理的模型上下文协议(MCP)服务器,旨在通过STDIO与Claude Desktop无缝集成。提供强大的代理查询、列表和配置工具。

目录

  • 用户指南
  • 概述
  • 用户旅程
  • 快速开始
  • 设置和配置
  • MCP工具参考
  • 存储体系统
  • 开发者指南
  • 项目结构
  • 开发设置
  • 测试
  • 日志记录和调试
  • API文档
  • 部署
  • 贡献
  • 许可证
  • 相关资源

用户指南

概述

Dust MCP服务器提供了一个标准化的接口,用于通过模型上下文协议(MCP)与Dust.tt代理进行交互。它能够与Claude Desktop和其他MCP兼容客户端无缝集成,提供代理发现、会话管理和消息处理等功能。

用户旅程

本节概述了与Dust MCP服务器及其集成代理交互时的典型用户旅程。

1.初始设置和代理发现

  • 入口点:用户登录Dust平台
  • 代理发现:
  • 查看代理市场中的可用代理
  • 按类别筛选代理(例如,数据分析、内容创建、研究)
  • 审查代理能力、评级和文档
  • 代理商选择:
  • 根据任务要求选择多个代理
  • 创建新工作区或选择现有工作区

2.工作空间配置

  • 布局设置:
  • 在自定义布局中排列代理面板
  • 配置特定于代理的设置和权限
  • 上下文共享:
  • 启用/禁用代理之间的上下文共享
  • 在代理之间建立数据流
  • 文件管理:
  • 将文件上传到共享工作区
  • 组织项目文件夹中的文件
  • 为每个代理设置文件访问权限

3.多智能体协作

  • 对话流程:
  • 启动与主代理的聊天
  • @提到其他代理人,让他们参与对话
  • 查看专用线程中的代理间通信
  • 任务委派:
  • 将特定任务分配给专业代理
  • 监控跨代理的任务进度
  • 查看任务依赖关系和状态
  • 文件协作:
  • 与特定代理共享文件
  • 跟踪文件访问和修改
  • 查看版本历史和代理贡献

4.高级交互

  • 代理商连锁:
  • 通过链接代理创建工作流
  • 为代理切换设置条件逻辑
  • 在代理之间配置自动触发器
  • 上下文管理:
  • 审查和编辑共享上下文
  • 解决代理之间的上下文冲突
  • 保存上下文快照以供将来参考

5.报告和分析

  • 报告生成:
  • 要求分析代理提供报告
  • 自定义报告模板和参数
  • 以多种格式导出报告(PDF、Markdown、HTML)
  • 洞察可视化:
  • 查看交互式仪表板
  • 过滤并深入数据可视化
  • 比较不同代理的输出

快速开始

先决条件

  • Node.js v18或更高版本
  • npm 9.x或更高版本
  • 拥有API访问权限的Dust.tt帐户
  • Redis服务器(用于会话管理)

会话管理

Dust MCP Server包括一个使用Redis进行持久化的强大会话管理系统。这允许跨服务器的多个实例进行安全和可扩展的会话处理。

特性

  • 基于Redis的会话存储:安全且可扩展的会话存储
  • 会话到期:自动清理过期会话
  • 分布式支持:适用于分布式环境
  • 会话数据:在每个会话中存储任意数据
  • API终点:用于会话管理的RESTful API

配置

Redis配置

  1. 环境变量
    将这些变量添加到您的 .env 文件:```env

Redis Configuration

REDIS_ENABLED=true # Set to false to disable Redis (uses in-memory store)
REDIS_URL=redis://localhost:6379
REDIS_PASSWORD= # Leave empty if no password is set
REDIS_TLS=false # Set to true for secure connections
SESSION_SECRET=your_session_secret_here
SESSION_TTL=86400 # 24 hours in seconds


1. **测试连接**

您可以通过以下方式测试Redis连接:```bash
node -e "const { createClient } = require('redis'); (async () => { const client = createClient({ url: process.env.REDIS_URL }); await client.connect(); console.log('Redis connected successfully'); await client.quit(); })().catch(console.error);"
  1. 禁用Redis进行开发

如果你想在没有Redis的情况下运行服务器进行开发:```env
REDIS_ENABLED=false


这将使用内存存储。注意:这不适合生产。

1. **跳过Redis缓存测试**

要跳过Redis相关测试,请设置以下环境变量:```bash
SKIP_REDIS_TESTS=true

或者在运行测试时:```bash
SKIP_REDIS_TESTS=true npm test


将这些环境变量添加到您的 `.env` 文件:```
# Redis Configuration
REDIS_URL=redis://localhost:6379
REDIS_PASSWORD=your_redis_password
REDIS_TLS=false
SESSION_SECRET=your_session_secret_here
SESSION_TTL=86400  # 24 hours in seconds

API终点

创建会话```http

POST /api/sessions
Content-Type: application/json

{
"userId": "user123",
"data": {
"role": "admin"
},
"ttl": 86400
}


#### 获取会话```http
GET /api/sessions/:sessionId
Authorization: Bearer

更新会话```http

PATCH /api/sessions/:sessionId
Authorization: Bearer
Content-Type: application/json

{
"data": {
"role": "admin",
"preferences": {}
},
"ttl": 86400
}


#### 删除会话```http
DELETE /api/sessions/:sessionId
Authorization: Bearer

验证会话```http

GET /api/sessions/:sessionId/validate
Authorization: Bearer


### 使用会话中间件

要使用会话身份验证保护路由,请使用 `sessionMiddleware`:```typescript
import { sessionMiddleware } from './session/routes/sessionRoutes';
import { redisClient } from './config/redis';

// Apply to specific routes
app.get('/protected-route', sessionMiddleware(redisClient), (req, res) => {
// Access session data
const session = req.session;
res.json({ message: 'Access granted', user: session.userId });
});

// Or apply to all routes
app.use(sessionMiddleware(redisClient));

会话数据结构```typescript

{
"sessionId": "unique-session-id",
"userId": "user123",
"data": {
// Custom session data
},
"expiresAt": "2025-05-25T12:00:00.000Z",
"createdAt": "2025-05-24T12:00:00.000Z",
"updatedAt": "2025-05-24T12:05:00.000Z"
}


### 最佳实践

1. **保护您的会话密钥**:使用强大、唯一的密钥进行会话加密
1. **设置适当的TTL**:设置会话TTL时平衡安全性和用户便利性
1. **验证会话**:在处理敏感操作之前,始终验证会话
1. **处理会话错误**:对会话相关操作实施适当的错误处理
1. **监控Redis**:监控Redis服务器运行状况和性能指标

### 故障排除

- **连接问题**:验证Redis服务器是否正在运行且可访问
- **会话过期**:通过调整TTL检查会话是否过期过快
- **内存使用**:监控大型会话数据的Redis内存使用情况
- **日志**:检查服务器日志中与会话相关的错误

### 会话存储选项

服务器支持不同的会话存储后端:

#### 内存存储(开发默认)

- 无需额外设置
- 服务器重启时会话丢失
- 非常适合本地开发和测试

#### Redis商店(推荐用于生产环境)```bash
# Install Redis (macOS)
brew install redis

# Start Redis server (in a separate terminal)
redis-server

# In your .env file:
SESSION_STORE_TYPE=redis
REDIS_URL=redis://localhost:6379

安装

  1. 克隆存储库:```bash
    git clone https://github.com/Ma3u/dust-mcp-server.git
    cd dust-mcp-server

1. 安装依赖项:```bash
npm install
  1. 设置环境变量:```bash
    cp .env.example .env

Edit .env with your configuration

LOG_LEVEL=info

Advanced Configuration

DUST_AGENT_IDS=agent1,agent2,agent3
MAX_SESSIONS=100
SESSION_TIMEOUT=3600


1. 构建项目:```bash
npm run build
  1. 启动服务器:```bash

For development

npm run dev

For production

npm start


## 设置和配置

### 环境变量

|变量|必填|描述|默认值|
|----------|----------|-------------|---------|
| `DUST_API_KEY` |是|您的Dust.tt API密钥|-|
| `DUST_WORKSPACE_ID` |是|您的Dust.tt工作区ID|-|
| `PORT` |无|运行服务器的端口| `3000` |
| `NODE_ENV` |否|节点环境(`development`/`production`) | `development` |
| `LOG_LEVEL` |否|日志记录级别(`error`, `warn`, `info`, `debug`) | `info` |
| `DUST_AGENT_IDS` |否|要加载的以逗号分隔的代理ID列表|-|
| `MAX_SESSIONS` |否|最大并发会话数| `100` |
| `SESSION_TIMEOUT` |否|会话超时(秒)| `3600` (1小时)|

### Claude桌面集成

要与Claude Desktop一起使用:

1. 全局安装MCP工具:```bash
npm install -g @modelcontextprotocol/tools
  1. 配置Claude Desktop以使用您的MCP服务器:```bash
    mcp configs set claude-desktop dust $(which node) $(pwd)/build/dust.js

1. 重新启动Claude Desktop并开始与您的Dust代理交互。

## MCP工具参考

以下MCP工具可用于与粉尘剂交互:

### `dust_list_agents`

列出配置的工作区中所有可用的除尘剂。

**参数:**

- `includeDetails` (boolean,可选):是否包含详细的代理信息

**例子:**```json
{
"includeDetails": true
}

dust_agent_query

向Dust代理发送查询。

参数:

  • agentId (string,必填):要查询的代理的ID
  • query (string,必填):要发送给代理的查询
  • sessionId (字符串,可选):用于继续对话的会话ID
  • context (object,可选):查询的其他上下文

例子:```json
{
"agentId": "agent123",
"query": "What is the weather today?",
"sessionId": "session_456"
}


## 存储体系统

内存库系统为代理状态和配置提供持久存储:

- **活动上下文**:跟踪所有活动代理会话的当前状态
- **决策日志**:记录所有代理决策和行动
- **进度跟踪**:监控任务进度和完成状态
- **系统模式**:定义可重用的交互模式
- **产品背景**:存储特定于产品的配置和数据

______________________________________________________________________

# 开发者指南

## 项目结构```text
dust-mcp-server/
├── src/
│   ├── __tests__/           # Test files
│   │   ├── e2e/             # End-to-end tests
│   │   ├── integration/     # Integration tests
│   │   └── unit/            # Unit tests
│   ├── agents/              # Agent implementations
│   ├── api/                 # API routes and controllers
│   ├── middleware/          # Express middleware
│   ├── services/            # Business logic services
│   ├── tools/               # MCP tool implementations
│   ├── types/               # TypeScript type definitions
│   └── utils/               # Utility functions
├── memory-bank/             # Persistent storage for agent state
│   ├── activeContext.md     # Current state of active sessions
│   ├── decisionLog.md       # Log of agent decisions
│   ├── progress.md          # Task progress tracking
│   ├── systemPatterns.md    # Reusable interaction patterns
│   └── productContext.md    # Product-specific configurations
├── docs/                    # Documentation files
├── tests/                   # Additional test resources
├── .env.example             # Example environment variables
├── .eslintrc.json           # ESLint configuration
├── .gitignore               # Git ignore rules
├── jest.config.ts           # Jest test configuration
├── package.json             # Project dependencies and scripts
├── README.md                # This file
└── tsconfig.json            # TypeScript configuration

开发设置

  1. 克隆存储库并安装依赖项:```bash
    git clone https://github.com/Ma3u/dust-mcp-server.git
    cd dust-mcp-server
    npm install

1. 设置您的开发环境:```bash
# Install development dependencies
npm install -D typescript ts-node ts-jest @types/jest @types/node

# Set up pre-commit hooks
npm run prepare
  1. 配置您的环境:```bash
    cp .env.example .env

Edit .env with your configuration


1. 启动开发服务器:```bash
npm run dev

测试

该项目包括一个全面的测试套件:

运行测试```bash

Run all tests

npm test

Run unit tests

npm run test:unit

Run integration tests

npm run test:integration

Run end-to-end tests

npm run test:e2e

Run tests with coverage

npm run test:coverage


### 测试结构

- **单元测试**:单独测试单个函数和类
- **集成测试**:测试组件之间的相互作用
- **E2E测试**:测试完整的用户流

### 测试特性

- 外部服务的模拟实现
- 包含样本数据的测试数据库
- API请求/响应验证
- UI组件的快照测试

## 日志记录和调试

应用程序使用Winston进行日志记录,日志级别如下:

- `error`:导致应用程序失败的错误
- `warn`:潜在的有害情况
- `info`:一般应用程序流程信息
- `debug`:详细的调试信息
- `silly`:非常详细的调试信息

### VS代码调试

将此配置添加到您的 `.vscode/launch.json`:```json
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Debug Tests",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "test:debug"],
"port": 9229,
"skipFiles": ["/**"]
}
]
}

常见问题

  1. TypeScript错误:运行 npm run lint:fix 自动修复常见问题
  2. 测试失败:使用清除测试数据库 npm run test:reset
  3. 依赖性问题:删除 node_modules 然后跑 npm install

API文档

API文档可在 docs 目录,可以使用以下命令生成:```bash
npm run docs:generate


API使用OpenAPI(Swagger)进行文档记录,可以在 `/api-docs` 在开发模式下运行时。

## 部署

### 先决条件

- Node.js 18+
- npm 9+
- Docker(可选)

### 生产建设```bash
# Install production dependencies
npm ci --only=production

# Build the application
npm run build

# Start the server
NODE_ENV=production npm start

码头工人```bash

Build the Docker image

docker build -t dust-mcp-server .

Run the container

docker run -p 3000:3000 --env-file .env dust-mcp-server


## 贡献

1. 分叉存储库
1. 创建要素分支(`git checkout -b feature/amazing-feature`)
1. 提交您的更改(`git commit -m 'Add some amazing feature'`)
1. 推到分支(`git push origin feature/amazing-feature`)
1. 打开拉取请求

## 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

## 相关资源

- Dust.tt文件
- 模型上下文协议
- 克劳德桌面
- Node.js文档
- TypeScript文档
- Express.js文档
- Jest测试框架
- 温斯顿测井

### 运行服务器

您可以在两种不同的模式下运行MCP服务器:HTTP模式或STDIO模式。

#### HTTP模式

要在HTTP模式下运行服务器(适用于基于web的客户端):```bash
npm run build
npm start -- --http

服务器将在指定的端口上侦听 PORT 环境变量(默认值:3000)。

您可以通过以下网址与API进行交互: http://localhost:3000/api.

SSE活动

服务器支持通过服务器发送事件(SSE)进行实时事件流式传输。

  • 连接到 http://localhost:3000/events 与SSE兼容的客户端一起接收服务器事件(例如,健康、代理更新)。
  • 示例使用 curl:```bash
    curl -N http://localhost:3000/events

#### STDIO模式

当您希望服务器通过标准输入/输出流而不是HTTP进行通信时,使用STDIO模式。这是Claude Desktop和其他通过STDIO通信的MCP客户端使用的模式。

要在STDIO模式下启动服务器:```bash
# Start the server in STDIO mode
node build/dust.js

在STDIO模式下运行时:

  • 服务器的设计不会向stdout产生任何输出,因为此通道是为MCP协议通信保留的
  • 任何日志或错误消息都会被定向到logs目录和stderr
  • 服务器立即准备好接受MCP客户端连接

停止服务器

要停止服务器,您可以在运行服务器的终端中使用Ctrl+C,或终止进程:```bash
pkill -f "node.*dust-mcp-server"


## 架构图```mermaid
flowchart TD
subgraph Client["Client Layer"]
A[Claude Desktop] -- "MCP Protocol" --> B[MCP Server]
end

subgraph Server["Dust MCP Server"]
B --> C[Request Handler]
C --> D[Auth Middleware]
D --> E[Windsurf Rules Engine]
E --> F[Tool Router]

subgraph Tools["MCP Tools"]
F --> G[dust_list_agents]
F --> H[dust_agent_query]
F --> I[dust_create_session]
F --> J[dust_end_session]
F --> K[dust_get_session]
F --> L[dust_get_agent]
end

subgraph Services["Core Services"]
M[DustApiService] <--> N[AgentService]
N <--> O[SessionManager]
O <--> P[MemoryBank]
end
end

subgraph External["External Services"]
Q[(Dust AI Platform)]
end

subgraph Memory["Memory Bank"]
R[productContext.md]
S[systemPatterns.md]
T[activeContext.md]
U[decisionLog.md]
V[progress.md]
end

Tools --> Services
Services --> Q
Services --> Memory

%% Styling
classDef client fill:#e1f5fe,stroke:#01579b,color:#01579b
classDef server fill:#e8f5e9,stroke:#2e7d32,color:#1b5e20
classDef external fill:#f3e5f5,stroke:#4a148c,color:#4a148c
classDef memory fill:#fff3e0,stroke:#e65100,color:#e65100

class A,Client client
class B,C,D,E,F,G,H,I,J,K,L,Server server
class Q,External external
class R,S,T,U,V,Memory memory

关键组件

  1. 客户端层:
  • Claude Desktop使用MCP协议与MCP服务器通信
  1. MCP服务器:
  • 请求处理器:处理传入的MCP请求
  • 身份验证中间件:验证API密钥和权限
  • 风浪规则引擎:强制执行特定于项目的规则和工作流
  • 工具路由器:将请求路由到相应的MCP工具
  • MCP工具:用于代理交互和会话管理的个人工具
  1. 核心服务:
  • DustApi服务:处理与Dust AI平台的通信
  • 代理服务:管理代理生命周期和交互
  • 会话管理器:维护会话状态和上下文
  • 记忆库:使用内存库系统管理持久存储
  1. 存储体:
  • productContext.md:项目目标和高层架构
  • systemPatterns.md:设计模式和实施细节
  • activeContext.md:现状和最近的变化
  • decisionLog.md:架构和实施决策
  • progress.md:任务跟踪和里程碑
  1. 外部服务:
  • Dust AI平台:代理执行和处理的外部服务

使用MCP工具

此项目使用 MCP工具 用于测试和集成。以下是如何使用它们:

  1. 全局安装MCP工具```bash
    npm install -g mcptools

2. 列出服务器中可用的工具```bash
mcp tools node build/dust.js
  1. 调用特定工具```bash
    mcp call dust_list_agents node build/dust.js --params '{"limit": 10}'

mcp call dust_agent_query node build/dust.js --params '{"query": "Give me a summary"}'


4. 将服务器添加到您的别名中```bash
mcp alias add dust node build/dust.js
mcp alias list
  1. 使用Claude Desktop进行配置```bash
    mcp configs set claude-desktop dust /path/to/node /path/to/dust-mcp-server/build/dust.js

## MCP工具参考

服务器提供以下MCP工具用于与Dust.tt代理交互:

### `dust_list_agents`

列出工作区中所有可用的代理。

**参数:**

- `query` (字符串,可选):按名称或描述筛选代理
- `view` (字符串,可选):筛选代理的视图类型
- `limit` (number,可选):要返回的最大代理数(默认值:10)

**请求示例:**```bash
mcp call dust_list_agents node build/dust.js --params '{"limit": 10}'

答复:```typescript
interface AgentDescriptor {
id: string;
name: string;
description: string;
capabilities: string[];
isActive?: boolean;
lastUsed?: string;
}


#### `dust_agent_query`

在会话中查询除尘剂。

**参数:**

- `agentId` (string,必填):要查询的代理的ID
- `message` (string,必填):要发送给代理的消息
- `files` (数组\<{name:string;content:string}>,可选):要包含在消息中的文件
- `sessionId` (字符串,可选):现有会话ID以继续对话

**请求示例:**```json
{
"agentId": "agent_123",
"message": "What's the weather like?",
"files": [
{
"name": "location.txt",
"content": "San Francisco"
}
]
}

答复:```typescript
interface DustMessageResponse {
response: string;
context: Record;
}


#### `dust_create_session`

使用Dust代理创建新会话。

**参数:**

- `agentId` (string,必填):用于创建会话的代理的ID
- `context` (object,可选):会话的初始上下文

**请求示例:**```bash
mcp call dust_create_session node build/dust.js --params '{
"agentId": "agent_123",
"context": {
"userPreferences": {
"language": "en-US"
}
}
}'

答复:```typescript
interface SessionDescriptor {
id: string;
agentId: string;
context: Record;
isActive: boolean;
createdAt: string;
lastActivity: string;
}


#### `dust_end_session`

结束活动会话。

**参数:**

- `sessionId` (string,必填):要结束的会话的ID

**请求示例:**```bash
mcp call dust_end_session node build/dust.js --params '{"sessionId": "sess_123"}'

dust_get_session

获取特定会话的详细信息。

参数:

  • sessionId (string,必填):要检索的会话的ID

请求示例:```bash
mcp call dust_get_session node build/dust.js --params '{"sessionId": "sess_123"}'


#### `dust_get_agent`

获取特定代理的详细信息。

**参数:**

- `agentId` (string,必填):要检索的代理的ID

**请求示例:**```bash
mcp call dust_get_agent node build/dust.js --params '{"agentId": "agent_123"}'

答复:```typescript
interface AgentDescriptor {
id: string;
name: string;
description: string;
capabilities: string[];
isActive: boolean;
createdAt: string;
updatedAt: string;
configuration: Record;
}


## 项目结构```text
root/
├── src/                # Main source code
│   ├── services/       # Dust API integration layer
│   └── tools/          # (Deprecated) MCP tool implementations
├── build/              # Compiled JavaScript output
├── logs/               # Application and debug logs
│   └── debug/
├── memory-bank/        # Project context and memory files
├── docs/               # Documentation, images, and moved test/demo scripts
├── .env                # Environment configuration (not committed)
├── .env.example        # Example environment file
├── package.json        # Project manifest
└── README.md           # Main documentation (this file)

测试

测试特性

测试套件包括以下功能:

  • 嘲笑:测试使用Jest mocking将MCP方法与实际API调用隔离开来
  • 测试数据:中提供了示例代理配置和响应 test/fixtures/
  • 参数验证:测试验证参数是否正确验证
  • 全覆盖:测试涵盖所有参数和响应格式

运行测试

您可以使用npm脚本运行测试:```bash

Install dependencies first (if not already installed)

npm install

Run all tests

npm test

Run only unit tests

npm run test:unit

Run only integration tests

npm run test:integration


### 手动测试

您还可以使用中的脚本手动测试MCP功能 `docs/`:```bash
# Test MCP tools functionality
node docs/test-mcp-tools.js

# Test STDIO transport
node docs/test-stdio.js

调试

VS代码调试

该项目包括服务器和测试的VS代码调试配置。您可以使用这些配置直接从VS Code调试应用程序。

可用的调试配置

  1. 调试服务器(HTTP)
  • 在调试模式下启动服务器并自动重新加载
  • 附加到正在运行的Node.js进程
  • 支持断点和步骤调试
  1. 调试测试
  • 在调试模式下运行测试套件
  • 支持测试文件中的断点
  • 显示详细的测试输出
  1. 调试当前测试文件
  • 运行当前打开的带有调试器的测试文件
  • 有助于专注于特定的测试用例
  • 支持测试文件和源代码中的断点
  1. 调试所有测试
  • 使用附加的调试器运行项目中的所有测试
  • 可用于调试测试套件或集成测试
  • 支持测试文件和源代码中的断点

如何使用

  1. 在VS Code中打开项目
  2. 通过单击行号旁边的空白处,在代码中设置断点
  3. 打开运行和调试视图(Ctrl+Shift+D或Cmd+Shift+D)
  4. 从下拉列表中选择调试配置
  5. 点击绿色播放按钮或按F5开始调试

日志文件

日志存储在 logs/ 目录:

  • app-YYYY-MM-DD.log:应用程序日志
  • server-YYYY-MM-DD.log:服务器日志
  • test-mcp-YYYY-MM-DD.log:MCP工具测试日志

发展```bash

Run in development mode with auto-reload

npm run dev

Build the project

npm run build
```

API文档

有关Dust API的更多信息,请参阅官方文档:

  • Dust API文件
  • 代理配置
  • 交谈
  • 消息

许可证

麻省理工学院

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Dust MCP Server (Ma3u) 怎么安装?

在客户端按下面的安装命令接入:docker run -p 3000:3000 --env-file .env dust-mcp-server。装完在客户端配置里引用同一个包或端点。

Dust MCP Server (Ma3u) 怎么在 Claude Desktop、Claude、Windsurf 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Dust MCP Server (Ma3u) 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Dust MCP Server (Ma3u) 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Dust MCP Server (Ma3u) 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Windsurf、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Dust MCP Server (Ma3u) 能提供哪些能力?

资料显示能力标签包括 多代理协作、HTML、Claude、会话管理。具体工具清单以官方文档为准。

Dust MCP Server (Ma3u) 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

Dust MCP Server (Ma3u) 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。