使用说明

项目简介

本项目 'random-num-mcp' 是一个基于 Model Context Protocol (MCP) 实现的服务器，旨在为大型语言模型 (LLM) 应用提供生成随机数的功能。作为一个独立的MCP服务器，它可以被配置到支持 MCP 协议的 LLM 客户端（如 Claude Desktop）中，通过工具调用的方式，让 LLM 能够方便地获取随机数。

主要功能点

提供随机数生成工具: 服务器注册了一个名为 'generate_random_number' 的工具，LLM 客户端可以调用此工具获取一个 0 到 100 之间的随机整数。
标准 MCP 协议: 基于 '@modelcontextprotocol/sdk' 开发，遵循 MCP 协议规范，确保与 MCP 客户端的兼容性。
Stdio 传输: 使用标准的 Stdio (标准输入输出) 作为传输协议，简化部署和集成。
易于部署和使用: 提供详细的安装和运行步骤，以及 Claude Desktop 的配置示例。

安装步骤

克隆仓库:

git clone [email protected]:Kohsuk3/random-num-mcp.git
cd random-num-mcp

安装依赖:
```
npm install
```
构建项目:
```
npm run build
```
启动服务器:
```
node build/index.js
```
启动成功后，终端会输出 'Random Number MCP server running on stdio'。

服务器配置

要将此 MCP 服务器配置到 MCP 客户端（例如 Claude Desktop）中，您需要提供服务器的启动命令和参数。以下是针对 Claude Desktop 的配置示例，您需要将以下 JSON 配置添加到 Claude Desktop 的配置文件中：

{
  "mcpServers": {
    "random-number": {  //  服务器名称，可以自定义，用于在客户端中标识该服务器
      "command": "node", // 启动服务器的命令，这里使用 node.js 运行时
      "args": ["path/to/random-number-server/build/index.js"] //  启动命令的参数，指向构建后的服务器入口文件。请将 "path/to/random-number-server" 替换为您的实际仓库路径
    }
  }
}

注意: 请将 'path/to/random-number-server' 替换为您克隆的 'random-num-mcp' 仓库在您本地文件系统中的绝对路径。

基本使用方法

配置完成后，在支持 MCP 协议的 LLM 客户端中，您可以通过工具调用机制来使用 'generate_random_number' 工具。例如，在 Claude Desktop 中，您可以指示 Claude 调用名为 'generate_random_number' 的工具，服务器将返回一个随机数。

例如，您可以向 Claude 提问： "请生成一个随机数"，Claude 可能会根据配置调用 'generate_random_number' 工具，然后将服务器返回的随机数信息提供给您。

关键词