使用说明

项目简介

Dust MCP Server 是一个基于 Model Context Protocol (MCP) 的简单服务器实现。它展示了如何使用 '@modelcontextprotocol/sdk' 库构建一个基本的 MCP 服务器,并注册一个名为 "dust" 的工具。该工具目前仅返回静态文本响应,用于演示 MCP 服务器的基本功能。

主要功能点

  • MCP 服务器实现: 使用 '@modelcontextprotocol/sdk/server/mcp.js' 库构建,符合 MCP 协议规范。
  • 工具注册: 注册了一个名为 "dust" 的工具,该工具接受枚举、数字和字符串类型的参数。
  • Stdio 传输: 使用 '@modelcontextprotocol/sdk/server/stdio.js' 库,通过标准输入/输出进行通信。
  • 简单的工具逻辑: 工具 "dust" 提供了静态文本响应,演示了工具的基本工作流程。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的系统中已安装 Node.js 和 npm (Node Package Manager)。
  2. 克隆仓库: 虽然这里只提供了代码片段,但假设这是一个完整的 GitHub 仓库,你需要先克隆该仓库到本地。
  3. 安装依赖: 在项目根目录下运行以下命令安装项目依赖:
    npm install @modelcontextprotocol/sdk
    npm install zod
    (实际上根据代码,只需要安装 '@modelcontextprotocol/sdk' 和 'zod' 即可)

服务器配置

MCP 客户端需要配置以下 JSON 信息才能连接到 Dust MCP Server。请注意,这里的配置是针对运行在本地环境的服务器,并使用 Stdio 传输。

{
  "serverName": ".",
  "command": "node",
  "args": ["src/index.js"]
}

配置参数说明:

  • 'serverName': 服务器名称,这里设置为 '"."',对应 'new McpServer({ name: ".", ... })' 中的配置。
  • 'command': 启动服务器的命令,这里使用 'node' 运行 JavaScript 代码。
  • 'args': 传递给 'command' 的参数,这里指定服务器入口文件为 'src/index.js'。

基本使用方法

  1. 启动服务器: 在项目根目录下,使用 MCP 客户端配置中指定的命令启动服务器。例如,在终端中直接运行 'node src/index.js'。服务器将开始监听标准输入。
  2. 使用 MCP 客户端: 配置 MCP 客户端连接到该服务器,并调用已注册的 "dust" 工具。
  3. 调用 "dust" 工具示例: MCP 客户端可以发送 JSON-RPC 请求来调用 "dust" 工具,例如:
    {
      "jsonrpc": "2.0",
      "method": "callTool",
      "params": {
        "toolName": "dust",
        "parameters": {
          "someEnum": "option1",
          "aNumber": 123,
          "aString": "hello"
        }
      },
      "id": 1
    }
    服务器将处理请求并返回工具的响应。在本例中,由于 "dust" 工具返回静态响应,客户端将收到包含固定文本 "This is the STATIC tool response to the user's request by the Multi-Agent System DUST" 的响应。

注意: 这是一个非常基础的 MCP 服务器示例,仅用于演示目的。"dust" 工具的逻辑非常简单,实际应用中需要根据具体需求扩展工具的功能和服务器的能力。

信息

分类

AI与计算