Dice Rolling MCP

🚀 ダイスロールMCPサーバー

このサーバーは、TypeScriptベースの包括的なモデルコンテキストプロトコル（MCP）サーバーで、AIアシスタントに高度なダイスロール機能を提供します。テーブルトップゲーム、RPG、およびゲームメカニクスを伴う洗練された乱数生成を必要とするアプリケーションに最適です。

🚀 クイックスタート

問題：大規模言語モデル（LLM）は実際にダイスを振ることができない

AIアシスタントに「ダイスを振る」ように依頼しても、実際には何も振られません。大規模言語モデルは、学習データのパターンに基づいて応答を生成する決定論的なシステムです。d20を振るように依頼すると、「14を振りました」などと応答するかもしれませんが、その数字は乱数生成ではなく、テキスト予測によって生成されたものです。

これにより、いくつかの問題が生じます：

• 真のランダム性がない：結果は本当にランダムではなく、予測可能なパターンに従う可能性があります。
• ゲームの公正性：公平なダイスロールがゲームプレイに影響するテーブルトップRPGでは重要です。
• シミュレーションの精度：統計シミュレーションには適切な乱数生成が必要です。
• 再現性の問題：同じプロンプトでも、不自然に似た「ランダム」な結果が得られることがあります。

解決策：AIに実際のダイスを与える

このMCPサーバーは、AIアシスタントと実際の乱数生成の間の橋渡し役として機能します。AIアシスタントにダイスを想像して振る代わりに、実際のダイスを与えるようなものです。

仕組み：

1. AIアシスタントがダイス表記（例：「3d6+2」）を受け取ります。
2. MCPサーバーがリクエストを解析し、暗号学的に安全な乱数を生成します。
3. 実際のダイスメカニクス（アドバンテージ、爆発的ダイス、リロールなど）が適用されます。
4. 真のランダムな結果がAIに返されます。

これにより、AIアシスタントは数学的な整合性を持った真のランダムなダイスロールを提供できるようになり、実際のゲーム、シミュレーション、および本物のランダム性を必要とするアプリケーションに適したものになります。

✨ 主な機能

標準的なダイス表記

• 基本的なロール：1d20、3d6、2d10
• モディファイア：1d20+5、2d6-3、1d8*2
• 複数のダイスタイプ：1d20+2d6+3
• パーセンタイルダイス：1d%（d100）
• ファッジダイス：4dF（Fate/Fudgeシステム）

高度なメカニクス

• アドバンテージ/ディスアドバンテージ：2d20kh1（最高値を保持）、2d20kl1（最低値を保持）
• ドロップメカニクス：4d6dl1（最低値をドロップ）、4d6dh1（最高値をドロップ）
• 爆発的ダイス：3d6!（最大値でリロールして加算）
• リロールメカニクス：4d6r1（1をリロール）
• 成功カウント：5d10>7（7以上の成功をカウント）

MCPツール

dice_roll

標準的な表記を使用してダイスロールを実行し、オプションでラベル付けと詳細な出力を提供します。

パラメータ：

• notation（必須）：ダイス表記文字列（例：「3d6+2」）
• label（オプション）：ロールの説明ラベル
• verbose（オプション）：個々のダイスの詳細な内訳を表示

dice_validate

ダイス表記を実行せずに検証し、表記の意味の詳細な内訳を提供します。

パラメータ：

• notation（必須）：検証するダイス表記文字列

📦 インストール

リモートMCP統合

このサーバーはデプロイされており、Claude Desktopですぐに使用できます。claude_desktop_config.jsonを次のように設定します：

{
  "mcpServers": {
    "dice-rolling-remote": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/client-stdio", 
        "connect", 
        "https://dice-rolling-mcp.vercel.app/mcp"
      ]
    }
  }
}

ローカルインストール

git clone https://github.com/jimmcq/dice-rolling-mcp
cd dice-rolling-mcp
npm install
npm run build

💻 使用例

Claude Desktopでの使用

claude_desktop_config.jsonに次のように追加します：

{
  "mcpServers": {
    "dice-roller": {
      "command": "node",
      "args": ["path/to/dice-rolling-mcp/dist/index.js"]
    }
  }
}

プラットフォーム固有の例：

Windows (WSL)：

{
  "mcpServers": {
    "dice-roller": {
      "command": "wsl",
      "args": ["node", "/path/to/dice-rolling-mcp/dist/index.js"]
    }
  }
}

macOS/Linux：

{
  "mcpServers": {
    "dice-roller": {
      "command": "node",
      "args": ["/path/to/dice-rolling-mcp/dist/index.js"]
    }
  }
}

スタンドアロンサーバー

npm run start

基本的な使用法

Human: Roll 3d6+2 for damage
Assistant: You rolled 3d6+2 for damage:
🎲 Total: 13
📊 Breakdown: 3d6:[4,2,5] + 2

高度な使用法

アドバンテージシステム

Human: Roll 2d20kh1+5 for attack with advantage
Assistant: You rolled 2d20kh1+5 for attack with advantage:
🎲 Total: 23
📊 Breakdown: 2d20:[12,18] keep highest + 5

検証

Human: Is "4d6kh3+2d8+5" valid dice notation?
Assistant: ✅ Valid dice notation: 4d6kh3+2d8+5

Breakdown:
• 4d6 (keep highest 3)
• 2d8
• Modifier: +5

📚 ドキュメント

アーキテクチャ

コアコンポーネント

• パーサー (src/parser/)：正規表現ベースの解析を使用してダイス表記をトークン化し、解析します。
• ローラー (src/roller/)：暗号学的に安全な乱数生成を使用してダイス式を実行します。
• MCPサーバー (src/index.ts)：AIアシスタントとの統合のためのモデルコンテキストプロトコルを実装します。
• 型システム (src/types.ts)：すべてのダイスメカニクスに対する包括的なTypeScript定義を提供します。

主要な設計決定

• セキュリティ：Node.jsのcrypto.randomInt()を使用して、暗号学的に安全なランダム性を実現します。
• 拡張性：モジュール化されたアーキテクチャにより、新しいダイスメカニクスを簡単に追加できます。
• 互換性：ES2022ターゲットで、より広いNode.jsバージョンをサポートするためのフォールバックがあります。
• 型安全性：完全なTypeScript実装で、厳格な型チェックを行います。

テスト

npm test

テストスイートは以下をカバーしています：

• すべてのサポートされるメカニクスに対するダイス表記の解析
• モックされた乱数生成を使用したロール実行
• エッジケースとエラーハンドリング
• MCPプロトコルの準拠

開発

プロジェクト構造

dice-rolling-mcp/
├── src/
│   ├── index.ts              # MCP server implementation
│   ├── parser/               # Dice notation parser
│   ├── roller/               # Dice rolling engine
│   ├── statistics/           # Statistical analysis tools
│   └── types.ts              # TypeScript definitions
├── __tests__/                # Test suite
├── dist/                     # Compiled JavaScript
└── examples/                 # Usage examples

新しいメカニクスの追加

1. types.tsのDiceTermインターフェースを拡張します。
2. dice-notation-parser.tsのパーサー正規表現を更新します。
3. dice-roller.tsにメカニクスを実装します。
4. 包括的なテストを追加します。

設定

サーバーは、DiceRollerConfigインターフェースを通じてさまざまな設定オプションをサポートしています：

• 1回のロールでの最大ダイス数
• 最大ダイスサイズ
• 乱数源の選択
• 履歴サイズの制限

🔧 技術詳細

📄 ライセンス

ISC

コントリビュート

コントリビューションは歓迎されます！以下を確認してください：

• すべてのテストが通過すること (npm test)
• コードが既存のパターンと規則に従っていること
• 新しい機能に適切なテストカバレッジがあること
• TypeScriptのstrictモードに準拠していること

リンク

• リポジトリ：https://github.com/jimmcq/dice-rolling-mcp
• ライブデモ：https://dice-rolling-mcp.vercel.app
• MCPエンドポイント：https://dice-rolling-mcp.vercel.app/mcp

作者

Jim McQuillan

• GitHub: https://github.com/jimmcq
• LinkedIn: https://www.linkedin.com/in/jimmcquillan/