MCP Server for Dust Agent Integration

这个指南将帮助你设置和运行连接到 Dust.tt 代理平台的 MCP 服务器。

安装

# 克隆仓库
git clone https://github.com/Ma3u/mcp-server-dust.git
cd mcp-server-dust

# 创建并激活虚拟环境
python3 -m venv .venv
source .venv/bin/activate  # Linux/macOS
# 或 .venv\Scripts\activate  # Windows

# 安装依赖
pip install mcp requests python-dotenv

配置

1. 复制 .env.example 并重命名为 .env
2. 填入你的 Dust 代理配置信息：

# MCP 服务器配置
MCP_NAME=Dust MCP Server
MCP_HOST=127.0.0.1
MCP_PORT=5001

# Dust 代理配置
DUST_AGENT_ID=your_agent_id
DUST_API_KEY=your_api_key
DUST_WORKSPACE_ID=your_workspace_id
# ...其他配置项

运行服务器

python server.py

成功启动会显示：

Starting MCP server 'Dust MCP Server' on 127.0.0.1:5001
Connected to Dust agent 'SystemsThinking' (ID: 8x9nu...)

与 Claude 桌面集成

1. 在 Claude 桌面中，进入设置 > 开发者
2. 点击编辑配置，添加 MCP 服务器：

{
    "mcpServers": {
        "dust": {
            "command": "/path/to/.venv/bin/python",
            "args": ["/path/to/server.py"],
            "host": "127.0.0.1",
            "port": 5001,
            "timeout": 10000
        }
    }
}

3. 完全退出并重启 Claude 桌面
4. 在 Claude 中测试：输入 Use Systemsthinking Agent to explain MCP Protocol.

故障排除

查看日志：

# 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

了解更多详情，请参阅项目文档：docs.md