Random Value MCP Server

随机值生成MCP服务器

生成随机数字和字符串Model Context Protocol (MCP) 服务器。

机能

• 随机数值生成：在指定范围内生成随机整数
• 随机字符串生成：生成指定长度的随机字母数字字符串
• 入力値検证：全面的错误处理和验证
• MCP準拠: MCP与协议规范完全兼容

工具

发电机随机数

生成指定范围内的随机整数。

参数：

• min (number): 最小值（包括）
• max (number): 最大值（包括）

例:

{
  "name": "generate_random_number",
  "arguments": {
    "min": 1,
    "max": 100
  }
}

generate_random_string

使用字母数字（A-Z，a-z，0-9）生成指定长度的随机字符串。

参数：

• length (number): 要生成的字符串长度（最小值：1）

例:

{
  "name": "generate_random_string",
  "arguments": {
    "length": 10
  }
}

安装

1. 克隆存储库
2. 安装依赖关系：

   npm install

1. 构建项目：

   npm run build

使用方法

直接実行

node dist/index.js

使用启动脚本

./bin/start.sh

MCP客户端设置

MCP添加到客户端设置：

{
  "mcpServers": {
    "random-value-server": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/path/to/random-value-mcp-server"
    }
  }
}

Claude Code统合

这个MCP打开服务器Claude Code要在中使用，请执行以下操作：

1. 确保服务器已构建并就绪：

   npm run build

1. Claude Code中所述修改相应参数的值。MCP配置文件（通常为 ~/.config/claude-code/mcp.json 、devcontainer如果在里面 claude mcp add random-value-generator node /workspace/dist/index.js 创建或编辑：

   {
     "mcpServers": {
       "random-value-server": {
         "command": "node",
         "args": ["dist/index.js"],
         "cwd": "/absolute/path/to/random-value-mcp-server"
       }
     }
   }

1. 新建MCP导入服务器Claude Code重新启动

1. 服务器Claude Code在会话中可用。可用：

- generate_random_number 随着 min 和 max 参数 - generate_random_string 随着 length 参数

Claude Code使用示例：

1から100の間のランダムな数値を生成してください。
8文字のランダムな文字列を生成してください。

Claude Code自动MCP使用服务器处理这些请求。

测试

运行测试套件：

node test/test-server.js

测试：

• 服务器初始化
• 工具列表
• 随机数值生成（有效、无效的情况）
• 随机字符串生成（有效、无效的情况）
• 错误处理

开発

• npm run build: TypeScript构建代码
• npm run dev：监视和重建更改
• npm run clean：清除构建对象

技术详细

• 协议：MCP（模型上下文协议）
• 传输：STDIO
• 言语：Types/Node.js
• 软件开发工具包：@modelcontextprotocol/sdk

错误处理

服务器包含全面的错误处理：

• 参数范围无效（数字min > max）
• 无效字符串长度（\<1）
• 缺少必需参数
• 未知工具名称

所有错误都是正确的MCP与说明性消息一起返回为错误响应。