MCP Server for Dust Agent Integration

MCP Server for Dust Agent Integration

site icon
2025.03.26 0
PythonAI代理集成系统思维代理检索增强生成开发效率交流协作
mcp-server-dust-Py 是一个多云提供商(MCP)服务器,专门用于与 Dust.tt 的 AI 代理平台集成。它通过 HTTP 调用将 Dust AI 代理的能力暴露给 MCP 接口。该服务器支持系统思维代理集成、检索增强生成(RAG)、网络导航能力等,并采用模块化代码结构以提高可维护性。
View on GitHub

Overview

基本能力

产品定位

mcp-server-dust-Py 是一个连接 Dust.tt AI 代理平台的 MCP 服务器,旨在通过标准化的 MCP 接口提供 AI 代理的高级功能。

核心功能

  • 通过 API 连接 Dust.tt AI 代理
  • 集成系统思维代理(认知神经科学和问题解决能力)
  • 支持检索增强生成(RAG)
  • 提供网络导航能力
  • 简化的 MCP 工具接口
  • 模块化代码结构以提高可维护性
  • 外部化配置和 API 客户端类

适用场景

  • 开发需要集成 AI 代理能力的应用程序
  • 构建需要系统思维和问题解决能力的工具
  • 实现基于检索增强生成的知识问答系统
  • 开发需要网络导航能力的自动化工具

工具列表

  • server.py: 主服务器实现,注册工具并处理 MCP 功能
  • config.py: 包含 DustAgentConfig 类,用于管理配置设置
  • api_client.py: 包含 DustAPIClient 类,处理与 Dust.tt 的 API 交互

常见问题解答

  • 400 Bad Request: 请求格式错误或缺少必填字段
  • 401 Unauthorized: API 密钥错误
  • 404 Not Found: 工作区 ID 或会话 ID 错误
  • 429 Too Many Requests: 超过 API 速率限制

使用教程

使用依赖

  • Python 3.10 或更高版本
  • pip 包管理器
  • Dust.tt 账户(具有 API 访问权限)
  • 现有的 Dust 代理配置

安装教程

  1. 克隆仓库: bash git clone https://github.com/Ma3u/mcp-server-dust.git cd mcp-server-dust
  2. 创建并激活虚拟环境: bash python3 -m venv .venv source .venv/bin/activate # macOS/Linux .venv\Scripts\activate # Windows
  3. 安装依赖: bash pip install --upgrade pip pip install mcp requests python-dotenv

调试方式

  1. 启动服务器: bash python server.py
  2. 查看日志: ```bash # macOS/Linux tail -f ~/Library/Logs/Claude/mcp-server-dust.log

# Windows Get-Content -Path "C:\Users{username}\AppData\Local\Logs\Claude\mcp-server-dust.log" -Wait ```

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。