MCP 灰尘服务器配置指南

项目介绍

MCP 灰尘服务器是一个用于与 Dust 代理进行通信的桥梁。通过配置 MCP 服务器，您可以将 Dust 代理集成到各种开发环境中，并利用其强大的功能。

安装与配置

创建 .env 文件

在项目的根目录下创建一个 .env 文件，并填写以下内容：

MCP_PORT=5001
MCP_MIN_PORT=5001
MCP_MAX_PORT=5001
DUST_API_KEY=your_api_key_here
DUST_WORKSPACE_ID=your_workspace_id_here
DUST_AGENT_ID=your_agent_id_here

将 your_api_key_here、your_workspace_id_here 和 your_agent_id_here 替换为您实际的 API 密钥和代理信息。

安装依赖

在项目目录中运行以下命令以安装所有依赖项：

npm install

启动服务器与客户端

同时启动服务器和客户端

npm run start

仅启动 MCP 服务器

npm run start:server

仅启动测试客户端

npm run start:client

预期输出

如果配置正确，您应该会看到以下输出：

对于 MCP 服务器：

MCP 服务器正在 http://127.0.0.1:5001 运行（超时时间：30s）
服务器名称：Dust MCP 桥接
Dust 工作区：your_workspace_id
Dust 代理：your_agent_id

对于 测试客户端：

MCP 测试客户端正在 http://127.0.0.1:6001 运行

API 端点

服务器提供了多个端点用于健康检查和 MCP 协议通信。有关详细文档，请参阅 开发者文档。

主要端点包括：

• 健康检查：/health，/ready，/live
• MCP 协议：/sse（服务器发送事件），/stream（HTTP 流传输）

调试

有关详细调试工具和技术信息，请参阅 开发者文档。

常见连接问题排查

如果您遇到与 MCP Inspector 或其他客户端的连接问题，请检查以下内容：

1. 确保 MCP 服务器正在运行。
2. 检查防火墙设置，确保端口未被阻止。
3. 查看控制台输出以获取任何错误信息。

集成指南

与Windsurf IDE集成

在 settings.json 文件中添加以下配置：

{
  "mcp-dust": {
    "serverUrl": "http://localhost:5001"
  }
}

与Claude Desktop集成

编辑 config.yml 文件，并添加以下内容：

mcp:
  server_url: http://localhost:5001

测试信息

您可以使用命令行或网页界面测试 MCP 服务器的功能。

开发者文档

有关详细技术文档，请参阅 开发者文档。

许可证

本项目遵循 MIT 许可证。