随机数 MCP 服务器

本项目实现了一个简单的模型上下文协议 (MCP) 服务器，该服务器提供一个使用 random.org API 生成随机数的工具。

概述

此服务器演示了 MCP 的基本概念，包括：

• 设置 MCP 服务器。
• 定义和实现工具。
• 与外部 API 集成。
• 配置服务器以供 MCP 客户端使用。

前提条件

• 已安装 Node.js 和 npm。
• 一个 MCP 客户端，例如 Claude 桌面应用程序。

项目设置

1. 克隆存储库：

   git clone [repository_url]
   cd [project_directory]
   

2. 安装依赖项：

   npm install
   

API

该服务器使用 random.org API 生成真正的随机数。 基本使用不需要 API 密钥。

MCP 服务器实现

服务器在 index.ts 中实现，并使用 @modelcontextprotocol/sdk 来处理 MCP 通信。

工具：get_random_number

此工具从 random.org API 检索一个随机整数。

输入参数：

• max（可选）：一个整数，指定随机数的最大值（包括）。 默认为 100。

输出：

• 一个包含随机数的字符串。

服务器配置

服务器通过 cline_mcp_settings.json 文件进行配置。 您需要为此服务器添加一个条目，指定运行它的命令：

{
  "mcpServers": {
    "random-number": {
      "command": "node",
      "args": ["[path/to/index.js]"],
      "env": {}
    }
  }
}

将 [path/to/index.js] 替换为已编译的 index.js 文件的实际路径（通常在运行 npm run build 后的 build 或 dist 目录中）。

运行服务器

1. 构建服务器

   npm run build
   

2. 启动服务器（这通常由 MCP 客户端在配置后自动完成）。

用法

服务器运行并配置完成后，您可以通过 MCP 客户端使用 get_random_number 工具。