Dice MCP Server

A Model Context Protocol (MCP) server implementation for a dice rolling application.

Features

• Implements MCP protocol for dice rolling
• Provides context and state management
• Supports roll and reset actions
• Maintains history of rolls
• RESTful API endpoints

API Endpoints

• GET /context - Get current dice context and state
• POST /action/roll - Roll the dice
• POST /action/reset - Reset dice state

Installation

npm install

Running the Server

Development mode:

npm run dev

Production mode:

npm start

Usage

The server exposes a Model Context Protocol API for dice rolling. You can interact with it using HTTP requests:

# Get context
curl http://localhost:3000/context

# Roll dice
curl -X POST http://localhost:3000/action/roll

# Reset dice
curl -X POST http://localhost:3000/action/reset

License

MIT