使用说明

项目简介

本项目 'Dust Agent MCP 服务器' 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在将 Dust.tt 平台上的 AI 智能体能力以标准化的 MCP 协议形式提供给 LLM 客户端，例如 Claude Desktop。它充当桥梁，使得支持 MCP 协议的客户端可以方便地调用 Dust.tt 智能体的功能，例如 RAG (检索增强生成)、Web 导航和系统思考等能力。

主要功能点

Dust.tt 智能体集成: 通过 API 调用连接 Dust.tt 平台，利用 Dust 智能体的强大功能。
系统思考智能体: 集成具备认知神经科学和问题解决能力的系统思考智能体。
RAG 支持: 支持检索增强生成，提升智能体的信息检索和生成能力。
Web 导航能力: 使智能体具备 Web 导航功能，扩展信息获取范围。
简化 MCP 工具接口: 提供简化的 MCP 工具接口，方便客户端调用。

安装步骤

克隆仓库:

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

创建并激活虚拟环境:

python3 -m venv .venv
source .venv/bin/activate  # macOS/Linux
.venv\Scripts\activate   # Windows

安装依赖:

pip install --upgrade pip
pip install mcp requests python-dotenv

配置环境变量:
- 复制 '.env.example' 文件并重命名为 '.env'。
- 根据您的 Dust.tt 账户信息和智能体配置，修改 '.env' 文件中的以下变量：
  - 'DUST_AGENT_ID': 您的 Dust 智能体 ID
  - 'DUST_DOMAIN': Dust API 域名 (默认为 'https://dust.tt')
  - 'DUST_WORKSPACE_ID': 您的 Dust 工作区 ID
  - 'DUST_WORKSPACE_NAME': 您的 Dust 工作区名称
  - 'DUST_API_KEY': 您的 Dust API 密钥
  - 'DUST_AGENT_NAME': 您的 Dust 智能体名称
  - 'DUST_TIMEZONE': 您的时区 (例如 'Europe/Berlin')
  - 'DUST_USERNAME': 您的用户名
  - 'DUST_FULLNAME': 您的全名

服务器配置

为了让 MCP 客户端（例如 Claude Desktop）连接到 'Dust Agent MCP 服务器'，您需要在客户端中配置服务器的启动命令和参数。以下是 Claude Desktop 的配置示例，您可以参考进行配置：

{
    "mcpServers": {
        "dust": {
            "command": "/path/to/mcp-server-dust/.venv/bin/python",  // 请替换为您的 python 虚拟环境路径
            "args": [
                "/path/to/mcp-server-dust/server.py"                 // 请替换为您的 server.py 文件路径
            ],
            "host": "127.0.0.1",                                     // MCP 服务器主机地址
            "port": 5001,                                            // MCP 服务器端口号
            "timeout": 10000                                         // 连接超时时间，单位毫秒
        }
    }
}

配置参数说明:

'command': 启动 MCP 服务器的命令，通常是 Python 解释器的路径。请根据您的实际环境配置 Python 虚拟环境的路径。
'args': 传递给启动命令的参数，这里指定了 'server.py' 脚本的路径。请根据您的实际项目路径配置 'server.py' 文件的路径。
'host': MCP 服务器监听的主机地址，默认为 '127.0.0.1' (本地主机)。
'port': MCP 服务器监听的端口号，默认为 '5001'。
'timeout': 客户端连接服务器的超时时间，单位为毫秒。

注意:

请将上述 JSON 配置添加到 Claude Desktop 的开发者配置 ('Developer' -> 'Edit Config') 中的 'mcpServers' 数组中。
如果 'mcpServers' 数组已存在其他服务器配置，请将 'dust' 的配置作为新的项添加到数组中。
配置完成后，需要完全退出并重新启动 Claude Desktop 才能使配置生效。

基本使用方法

启动 MCP 服务器: 在终端中，进入 'mcp-server-dust' 仓库目录，并运行以下命令启动服务器：
```
python server.py
```
启动成功后，您应该看到类似 'Starting MCP server 'Dust MCP Server' on 127.0.0.1:5001' 的输出信息。
在 MCP 客户端中使用: 以 Claude Desktop 为例，配置完成后，您可以在 Claude Desktop 中通过指令来调用 Dust.tt 智能体的能力。例如，在 Claude Desktop 中输入：
```
Use Systemsthinking Agent to explain MCP Protocol.
```
Claude Desktop 将会把请求发送到 'Dust Agent MCP 服务器'，服务器会调用 Dust.tt 的 'Systemsthinking Agent' 智能体来解释 MCP 协议，并将结果返回给 Claude Desktop。

您可以使用 'Use [智能体名称] to [你的问题]' 的格式来指示 Claude Desktop 使用特定的 Dust.tt 智能体来处理您的请求。

关键词