使用说明
项目简介
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" 提供了静态文本响应,演示了工具的基本工作流程。
安装步骤
- 安装 Node.js 和 npm: 确保你的系统中已安装 Node.js 和 npm (Node Package Manager)。
- 克隆仓库: 虽然这里只提供了代码片段,但假设这是一个完整的 GitHub 仓库,你需要先克隆该仓库到本地。
- 安装依赖: 在项目根目录下运行以下命令安装项目依赖:
(实际上根据代码,只需要安装 '@modelcontextprotocol/sdk' 和 'zod' 即可)npm install @modelcontextprotocol/sdk npm install 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'。
基本使用方法
- 启动服务器: 在项目根目录下,使用 MCP 客户端配置中指定的命令启动服务器。例如,在终端中直接运行 'node src/index.js'。服务器将开始监听标准输入。
- 使用 MCP 客户端: 配置 MCP 客户端连接到该服务器,并调用已注册的 "dust" 工具。
- 调用 "dust" 工具示例: MCP 客户端可以发送 JSON-RPC 请求来调用 "dust" 工具,例如:
服务器将处理请求并返回工具的响应。在本例中,由于 "dust" 工具返回静态响应,客户端将收到包含固定文本 "This is the STATIC tool response to the user's request by the Multi-Agent System DUST" 的响应。{ "jsonrpc": "2.0", "method": "callTool", "params": { "toolName": "dust", "parameters": { "someEnum": "option1", "aNumber": 123, "aString": "hello" } }, "id": 1 }
注意: 这是一个非常基础的 MCP 服务器示例,仅用于演示目的。"dust" 工具的逻辑非常简单,实际应用中需要根据具体需求扩展工具的功能和服务器的能力。
信息
分类
AI与计算