🚀 随机数 MCP 服务器

本项目实现了一个简易的模型上下文协议（MCP）服务器，提供了一个借助 random.org API 生成随机数的工具，为随机数生成提供了便捷途径。

🚀 快速开始

先决条件

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

项目设置

1. 克隆仓库

   git clone [repository_url]
   cd [project_directory]
   

2. 安装依赖项

   npm install
   

服务器配置

服务器通过 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 概念演示：该服务器展示了 MCP 的基本概念，涵盖设置 MCP 服务器、定义和实现工具、集成外部 API 以及配置服务器以供 MCP 客户端使用等方面。
• 随机数生成：借助 random.org API 生成真正的随机数，且基本使用无需 API 密钥。

📚 详细文档

API

此服务器运用 random.org API 生成真正的随机数，基本使用无需 API 密钥。

MCP 服务器实现

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

工具：get_random_number

该工具可从 random.org API 获取一个随机整数。

• 输入参数：
  • max（可选）：指定最大值的整数（包含），默认为 100。
• 输出：包含随机数字的字符串。

💻 使用示例

基础用法

一旦服务器运行并配置好，您就可以通过 MCP 客户端使用 get_random_number 工具。例如，您可以在 MCP 客户端中调用该工具获取随机数。