diceport

diceport

diceport はサイコロを振り、コインを投げ、ランダムな整数を選びます。 スクリプトやエージェントに公平で説明可能な偶然性が必要な場面を想定して 作られています。サイコロを振ると、合計に使われた目がすべて表示され、 どの呼び出しにもシードを指定して結果を再現できます。同じシードなら、 いつでも同じ結果になります。

インストール

npx @reneturcios/diceport roll 2d6

または、コンテナイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/diceport

コンテナはデフォルトで MCP サーバーとして動作します（以下を参照）。CLI として使うには、CLI 引数を渡してください。

CLI

# Roll dice in NdM notation, with an optional +N / -N modifier
diceport roll 2d6
# 2d6: [3, 5] total 8
diceport roll 3d8+2 --seed 42   # reproducible

# Flip a coin
diceport flip                   # heads (or tails)
diceport flip --seed 7 --json

# Pick an integer between two bounds, inclusive
diceport random 1 100
diceport random 1 100 --seed 42

diceport --version

記法は NdM です。N 個の M 面ダイスを振ります。個数は省略でき（d20 は 1 個のダイスを振ります）、固定の修正値を末尾に追加できます（2d6+3、 1d100-5）。

終了コード：成功時は 0、ロールまたは範囲を処理できない場合（記法が 不正、範囲の上下限が逆など。エラーで理由を説明します）は 1、使用法 エラーの場合は 2 です。

MCP サーバー

どちらのインターフェースも、1 つのバイナリで利用できます。mcp サブ コマンドで stdio MCP サーバーを起動します。

npx -y @reneturcios/diceport mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "diceport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/diceport", "mcp"]
    }
  }
}

ツール

ツール	入力	返される内容
roll_dice	notation（文字列、必須。例：2d6+3）、seed（整数、任意）	振った各ダイスの目、修正値、合計。
flip_coin	seed（整数、任意）	heads または tails。
random_number	min、max（整数、必須）、seed（整数、任意）	min から max までの範囲（両端を含む）から選ばれた整数。

シードを指定した呼び出しでは mulberry32 ジェネレーターを使用するため、 シードによって結果が完全に決まり、報告された結果を再現できます。シードを 指定しない呼び出しでは、プラットフォームのランダムソースから値を取得します。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。