关键词

FizzBuzz工具NodeJS示例MCP SDK

FizzBuzz MCP服务器示例

项目简介

这是一个基于NodeJS实现的简单MCP服务器，它提供了一个名为 'fizzbuzz' 的工具。该工具接受一个数字 'n' 作为输入，并返回从 1 到 'n' 的 FizzBuzz 结果。此示例旨在帮助开发者理解MCP服务器的基本结构和工具的实现方式。

主要功能点

  • 提供 FizzBuzz 工具: 服务器注册并提供了一个 'fizzbuzz' 工具，客户端可以调用此工具来执行 FizzBuzz 计算。
  • 基于标准 MCP 协议: 服务器遵循 MCP 协议规范，使用 JSON-RPC 进行通信，并支持 'initialize', 'tools/list', 'tools/call' 等核心方法。
  • Stdio 传输: 使用 Stdio 作为传输协议，方便本地开发和测试。

安装步骤

  1. 安装 Node.js: 确保您的系统已安装 Node.js 运行时环境。您可以从 https://nodejs.org/ 下载并安装。
  2. 下载仓库代码: 从 GitHub 仓库 https://github.com/ccollicutt/mcp-fizzbuzz 下载代码到本地。
  3. 进入项目目录: 在终端中，导航到您下载的代码仓库目录。
  4. 运行服务器: 在终端中执行命令 'node mcp-fizzbuzz-server.js' 启动服务器。您应该在终端看到 'STARTING FIZZBUZZ MCP SERVER' 和 'Server connected' 的日志输出，表示服务器已成功启动。

服务器配置

要将此 MCP 服务器连接到 MCP 客户端（例如 Cursor），您需要配置客户端的 MCP 设置。以下是一个示例配置，您需要将其添加到 MCP 客户端的服务器列表中。

{
  "serverName": "fizzbuzz",
  "command": "node",
  "args": ["mcp-fizzbuzz-server.js"]
}

配置参数说明:

  • 'serverName': 服务器的名称，可以自定义，例如 "fizzbuzz-server"。
  • 'command': 启动服务器的命令，这里是 'node'，因为我们的服务器是 NodeJS 应用。
  • 'args': 命令的参数，这里是 '["mcp-fizzbuzz-server.js"]'，指定了服务器脚本的文件名。

基本使用方法

  1. 启动 MCP 客户端: 打开您配置了 MCP 服务器的 MCP 客户端（例如 Cursor）。
  2. 在 Agent 模式下提问: 在客户端的 Agent 模式下，向 Agent 提问，要求它使用 'fizzbuzz' 工具。例如，您可以提问 "请对数字 15 进行 FizzBuzz"。
  3. Agent 调用工具: Agent 应该能够识别出 'fizzbuzz' 工具并询问您是否允许使用。
  4. 允许工具使用: 允许 Agent 使用 'fizzbuzz' 工具。
  5. 查看结果: Agent 应该返回 FizzBuzz 工具的计算结果，即从 1 到 15 的 FizzBuzz 字符串。

通过以上步骤，您就可以体验到如何使用这个简单的 FizzBuzz MCP 服务器。

信息

分类

开发者工具

访问项目