🚀 MCP 灰尘服务器配置指南

MCP 灰尘服务器是一个用于连接 Dust 代理的桥梁，借助它，你能将 Dust 代理集成到各类开发环境中，充分发挥其强大功能。

🚀 快速开始

MCP 灰尘服务器可作为与 Dust 代理通信的桥梁。通过合理配置，你可以将 Dust 代理集成到不同的开发环境中，从而利用其强大的功能。

✨ 主要特性

• 作为桥梁实现与 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 许可证。