llmdm

module

v0.0.0-...-5a3a3e4 Latest Latest Go to latest Published: Mar 25, 2026 License: MIT

Details

A Go MCP server for D&D campaign state management, dice rolling, and session memory.

The game/ directory contains a ready-to-play workspace for running D&D campaigns.

(Optional) Set up AI session compression:

cd game
echo "ANTHROPIC_API_KEY=your-key-here" > .env

Navigate to game directory and start Claude Code:
```
cd game
claude
```
Start a new campaign or continue existing:
```
/create-campaign
/continue
```
Play! Claude acts as DM with:
- Real dice rolls via MCP server
- Persistent character sheets in SQLite
- AI-compressed session history
- Automatic plot hook tracking
End your session:
```
/end
```

Campaign state persists in SQLite, so start fresh Claude Code sessions without losing progress.

When to start fresh:

Resume after refresh:

exit
claude
/continue

Campaign data is stored in ./data/campaigns/ - never needs cleaning.

Complete documentation in docs/:

make build
make test
make run

See Deployment Guide for transport modes and configuration.

MIT License

Path	Synopsis
cmd
server command Package main is the entry point for the D&D Campaign MCP server.	Package main is the entry point for the D&D Campaign MCP server.
config Package config handles environment and configuration loading.	Package config handles environment and configuration loading.
internal
db Package db provides SQLite database connection and migrations.	Package db provides SQLite database connection and migrations.
dice Package dice provides dice notation parsing and rolling.	Package dice provides dice notation parsing and rolling.
dm
mcpserver
memory Package memory provides campaign memory storage and retrieval.	Package memory provides campaign memory storage and retrieval.
session
types Package types contains shared structs for the D&D campaign MCP server.	Package types contains shared structs for the D&D campaign MCP server.