Random Generation

🚀 MCP 随机数

MCP 随机数は、多様な乱数生成機能を提供する MCP サーバーです。RFC 4122 標準に準拠した UUID、乱数、文字列、パスワード、ガウス分布乱数、サイコロの振り、カードの抽選などの機能をサポートしています。

🚀 クイックスタート

MCP 随机数は、多くの乱数生成機能を提供する便利なツールです。以下のセクションでは、インストール方法、機能特性、使用例などについて説明します。

📦 インストール

npm または yarn を使用してインストールできます。

ローカルインストール

npm install mcp-rand
# または
yarn add mcp-rand

グローバルインストール

npm install -g mcp-rand

✨ 主な機能

UUID 生成器

• RFC 4122 標準に準拠しています。
• Node の crypto モジュールを使用して実装されています。
• パラメータは必要ありません。

乱数生成器

• 整数と浮動小数点数の生成をサポートしています。
• 範囲と分布方式（均等、正規など）を指定できます。

文字列生成器

• 指定された長さの文字列をランダムに生成します。
• 文字セットをカスタマイズできます。

パスワード生成器

• 安全性の高いランダムなパスワードを自動生成します。
• パスワードの複雑さ要件（大文字、小文字、数字、特殊記号の含む）を設定できます。

ガウス分布生成器

• Box-Muller アルゴリズムに基づいて実装されています。
• 平均値と標準偏差を指定できます。

サイコロシミュレーター

• サイコロを振る過程をシミュレートします。
• サイコロの面数（6 面、8 面など）を指定できます。

カード抽選ツール

• 標準のトランプから指定された枚数のカードを抽選できます。
• 残りのカード枚数と現在の山札の状態を記録します。

💻 使用例

コマンドラインツール

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
# 6 面のサイコロを振るシミュレーションを行い、結果を出力します。例：4

mcp-rand draw-cards --count 5
# 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 }); // 6 面のサイコロを振るシミュレーションを行い、結果を出力します。例：4

// カードの抽選
const result1 = MCP_rand drawCards, { count: 5 };
console.log(result1); // 5 枚のカードを抽選し、残りのカード枚数と山札の状態を出力します。

const result2 = MCP_rand drawCards, { count: 3, seed: result1.seed };
console.log(result2); // 同じ山札から 3 枚のカードをさらに抽選します。

貢献者

• Alice - 初期実装
• Bob - ガウス分布機能の追加
• Charlie - カード抽選機能の改善

📄 ライセンス

MCP Rand は、Apache License 2.0 ライセンスによって保護されています。