Roll Dice MCP Server

Model Context Protocol for Claude Desktop

GitHub
✨ MCP Server Ready

Add Dice Rolling to Claude Desktop

A powerful Model Context Protocol server that lets you roll dice of any size directly within Claude Desktop conversations.

Step 1: Install Claude Desktop
First, you'll need to download and install Claude Desktop on your computer.
Windows
  1. Visit the Claude Desktop download page
  2. Download the Windows installer (.exe)
  3. Run the installer and follow the prompts
  4. Launch Claude Desktop from Start Menu
Download for Windows
macOS
  1. Visit the Claude Desktop download page
  2. Download the macOS installer (.dmg)
  3. Open the DMG and drag Claude to Applications
  4. Launch Claude Desktop from Applications
Download for macOS
Step 2: Choose Your Setup Method
You can use this MCP server in two ways: running locally or using the cloud deployment.
🖥️Local Development

Run the server on your local machine for development and testing.

Steps:

  1. Clone this repository to your computer
  2. Run npm install
  3. Run npm run dev
  4. Server will be available at localhost:3000

Best for: Development, customization, and when you want full control

☁️Cloud Deployment

Use the already deployed version without running anything locally.

Steps:

  1. No local setup required!
  2. Use the configuration provided in Step 3
  3. The server is already running in the cloud
  4. Always available and up-to-date

Best for: Quick setup, permanent use, and convenience

💡 Pro Tip

You can switch between local and cloud configurations anytime by updating your Claude Desktop config file. Many users start with the cloud deployment for quick testing, then switch to local for customization.

Step 3: Configure Claude Desktop
Add the MCP server configuration to Claude Desktop based on your deployment type.

Configuration File Location:

Windows:

%APPDATA%\Claude\claude_desktop_config.json

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Configuration Content:

Choose the configuration that matches your deployment:

🏠 Local Development: Use this configuration when running the server locally with npm run dev

claude_desktop_config.json (Local)
{
  "mcpServers": {
    "rolldice": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://localhost:3000/api/mcp"
      ]
    }
  }
}

Requirements:

  • Server must be running on http://localhost:3000
  • Keep the development server running while using Claude Desktop

Important Notes:

  • • If the config file doesn't exist, create it
  • • Make sure the server is accessible before using Claude Desktop
  • • You may need to enable Developer mode in Claude Desktop settings
  • • For cloud deployments, ensure your deployment is live and accessible
Step 4: Restart Claude Desktop
Restart Claude Desktop to load the new MCP server configuration.
  1. Completely close Claude Desktop
  2. Reopen Claude Desktop
  3. Look for a hammer icon (🔨) in the bottom right of the input box
  4. The hammer icon indicates MCP tools are available

✅ If you see the hammer icon, you're ready to start rolling dice!