Random Generation

🚀 MCP 隨機數

MCP 隨機數是一個 MCP 服務器，提供多種隨機生成功能。它能生成符合 RFC 4122 標準的 UUID、隨機數字、字符串、密碼、高斯分佈隨機數，還能模擬擲骰子和抽卡片。

🚀 快速開始

MCP 隨機數提供了豐富的隨機生成功能，可通過命令行工具或集成到 MCP 客戶端使用。

✨ 主要特性

• UUID 生成器：

  • 符合 RFC 4122 標準。
  • 使用 Node 的 crypto 模塊實現。
  • 無需任何參數。

• 隨機數生成器：

  • 支持生成整數和浮點數。
  • 可指定範圍和分佈方式（均勻、正態等）。

• 字符串生成器：

  • 隨機生成指定長度的字符串。
  • 支持自定義字符集。

• 密碼生成器：

  • 自動生成安全強度高的隨機密碼。
  • 可設置密碼複雜度要求（如包含大寫字母、小寫字母、數字和特殊符號）。

• 高斯分佈生成器：

  • 基於 Box - Muller 算法實現。
  • 支持指定均值和標準差。

• 擲骰子模擬器：

  • 模擬擲色子的過程。
  • 可指定骰子的面數（如六面、八面等）。

• 抽卡片工具：

  • 支持從標準撲克牌中抽取指定數量的卡片。
  • 記錄剩餘牌數和當前牌堆狀態。

📦 安裝指南

你可以通過 npm 或 yarn 進行安裝：

npm install mcp-rand
# 或者
yarn add mcp-rand

全局安裝：

npm install -g mcp-rand

💻 使用示例

基礎用法

命令行工具

mcp-rand generate-uuid
# 輸出類似：36b1ff8e-c2c4-4f70-b5f9-3aee277d20bf

mcp-rand random-number --min 1 --max 10
# 輸出一個 1 到 10 之間的隨機整數，例如：7

mcp-rand string-generator --length 8
# 輸出類似：rF@k9P!q

mcp-rand password-generator --strength strong
# 輸出一個強密碼，例如：$L4fG^2w&5tQ

mcp-rand gaussian-generator --mean 0 --stddev 1
# 輸出一個符合標準正態分佈的隨機數，例如：-0.34256789

mcp-rand dice-simulator --sides 6
# 模擬擲一個六面骰子，輸出結果，例如：4

mcp-rand draw-cards --count 5
# 輸出抽到的五張牌及其剩餘牌數和牌堆狀態。

MCP 客戶端集成

const { MCP_rand } = require('mcp-rand');

// 生成 UUID
console.log(MCP_rand.generateUUID()); // 輸出類似：36b1ff8e-c2c4-4f70-b5f9-3aee277d20bf

// 隨機數生成
console.log(MCP_rand.randomNumber({ min: 1, max: 10 })); // 輸出一個 1 到 10 之間的隨機整數，例如：7

// 字符串生成
console.log(MCP_rand.generateString({ length: 8 })); // 輸出類似：rF@k9P!q

// 密碼生成
console.log(MCP_rand.generatePassword({ strength: 'strong' })); // 輸出一個強密碼，例如：$L4fG^2w&5tQ

// 高斯分佈生成
console.log(MCP_rand.generateGaussian({ mean: 0, stddev: 1 })); // 輸出一個符合標準正態分佈的隨機數，例如：-0.34256789

// 擲骰子模擬
console.log(MCP_rand.rollDice({ sides: 6 })); // 模擬擲一個六面骰子，輸出結果，例如：4

// 抽卡片
const result1 = MCP_rand.drawCards({ count: 5 });
console.log(result1); // 輸出抽到的五張牌及其剩餘牌數和牌堆狀態。

const result2 = MCP_rand.drawCards({ count: 3, seed: result1.seed });
console.log(result2); // 繼續從同一個牌堆中抽取三張牌。

貢獻者

• Alice - 初始實現
• Bob - 高斯分佈功能的添加
• Charlie - 抽卡片功能的完善

📄 許可證

MCP Rand 由 Apache License 2.0 許可證保護。