MCP Dice

🚀 mcp-dice：サイコロを振るためのMCPサーバ

Model Context Protocol (MCP)サーバで、大規模言語モデル（LLMs）がサイコロを振ることを可能にします。標準的なサイコロ表記（例：1d20）をサポートし、各サイコロの結果とその合計を返します。

✨ 主な機能

• 標準的なサイコロ表記（例：1d20、3d6、2d8+1）をサポート
• 各サイコロの結果とその合計を返す
• Claude Desktopと簡単に統合可能
• デバッグ用にMCP Inspectorと互換性がある

📦 インストール

Smitheryを通じたインストール

Smitheryを通じてClaude Desktop用のDice Rollerを自動インストールするには：

npx @smithery/cli install mcp-dice --client claude

uvを使用可能にする：https://docs.astral.sh/uv/getting-started/installation/

💻 使用例

基本的なコマンドラインの使用法

# uvxを使用
uvx mcp-dice

入力形式

サーバはnotationフィールドを含むJSONオブジェクトを受け付けます：

{
  "notation": "2d6+3"
}

応答例：

{
  "rolls": [
    3,
    1
  ],
  "sum": 4,
  "modifier": 3,
  "total": 7,
  "notation": "2d6+3",
  "timestamp": "2024-12-03T16:36:38.926452"
}

📚 ドキュメント

Claude Desktopの設定

位置

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json%

例

{
  "mcpServers": {
    "dice": {
      "command": "uvx",
      "args": ["mcp-dice"]
    }
  }
}

{
  "mcpServers": {
    "dice": {
      "command": "wsl",
      "args": [
        "-e",
        "zsh",
        "-lc",
        "uvx mcp-dice"
      ]
    }
  }
}

開発とデバッグ

開発用依存関係のインストール

# リポジトリをクローン
git clone https://github.com/yourusername/mcp-dice
cd mcp-dice

# 開発用依存関係をインストール
uv pip install -e ".[dev]"

テストの実行

uv run pytest

MCP Inspectorの使用

MCP Inspectorは、MCPサーバをデバッグするための便利なツールです。npmでインストールして実行します：

npx @modelcontextprotocol/inspector uvx mcp-dice

Claude Desktopの設定（開発用）

{
  "mcpServers": {
    "dice": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "path/to/mcp-dice-repo",
        "mcp-dice"
      ]
    }
  }
}

{
  "mcpServers": {
    "dice": {
      "command": "wsl",
      "args": [
        "-e",