Random Number MCP

关键词

随机数安全令牌工具调用JSON-RPC微服务

使用说明（Markdown 格式）

  • 项目简介 本项目实现了一个基于 MCP（Model Context Protocol）的后端服务器，使用 FastMCP 框架将一组随机数相关的工具对外暴露给 MCP 客户端。客户端可以通过 JSON-RPC 调用服务器提供的工具，如生成随机整数、随机小数、带权随机、打乱列表、随机取样，以及加密相关的随机令牌和随机整数等。

  • 主要功能点

    • 暴露工具接口：random_int、random_float、random_choices、random_shuffle、random_sample、secure_token_hex、secure_random_int。
    • 支持带权选取和无放回随机取样等常用随机相关操作。
    • 通过 MCP JSON-RPC 与客户端通信，工具调用结果以标准响应返回。
    • 测试覆盖工具行为，包括输入校验、错误处理和边界情况。

  • 安装步骤

    1. 确保使用 Python 3.10 及以上版本已安装。
    2. 安装依赖并获取源码（从仓库克隆或下载）。本项目依赖 FastMCP 等 MCP 相关库，请按照项目提供的依赖方式安装。
    3. 在项目根目录执行运行命令以启动服务器，例如通过 Python 模块方式启动服务器：python -m random_number_mcp.server
    4. 如使用 MCP Inspector 等工具进行本地调试，请确保 MCP 客户端能连接到服务器的启动方式与参数。

  • 服务器配置（MCP 客户端使用的最小配置示例，需在客户端配置中提供以下信息以建立连接）

    • 服务器名称（server name）：random-number
    • 启动命令（command）：uv
    • 启动参数（args）：["--directory", "<path_to_your_repo>/random-number-mcp", "run", "random-number-mcp"] 说明：以上命令为本仓库在开发/测试环境中常用的启动方式之一，使用 UV 工具从指定目录加载 MCP 服务模块并启动。若以直接 Python 模块运行，请使用 python -m random_number_mcp.server 的方式来启动。

    参考配置信息（JSON 结构，仅用于描述，不在客户端代码中执行）： { "mcpServers": { "random-number": { "command": "uv", "args": ["--directory", "<path_to_your_repo>/random-number-mcp", "run", "random-number-mcp"] } // 实际路径请按本地环境替换为你的仓库路径 } }

  • 基本使用方法

    • 启动服务器后，MCP 客户端可通过 JSON-RPC 调用工具接口，如请求随机整数、浮点数、打乱列表等。
    • 工具调用的示例参数由各工具的文档说明，客户端应按需传入 low/high、population、k、weights 等参数。
    • 服务器会对输入进行校验并返回结果，错误场景将返回明确的错误信息。

服务器信息

访问项目