Easychatdm

EasyChatDM is an educational project for creating simple MCP server tools, aiming to provide random decision - making tools for D&D games through generative AI.

Games and gamification Education and learning tools #Random decision - making #D&D tool #MCP service #Educational project .Java

rating : 2.5 points

downloads : 7.7K

update time : 2025-04-28

Open Site

What is EasyChatDM?

EasyChatDM is a set of server tools based on the MCP protocol, specifically designed for D&D games using generative AI (such as Claude). It provides various random table functions, including yes/no Q&A, event generation, NPC descriptions, etc., adding uncertainty and fun to the game.

How to use EasyChatDM?

You need to copy the prompt files to the specified directory and then connect and use them through a client that supports the MCP protocol (such as the Claude desktop version). These tools will provide services such as random event generation as an extended function of the AI.

Applicable scenarios

Suitable for single - player D&D games with AI when random events, NPC generation, or plot twists are needed. It can also be used as an AI - assisted game master (DM) tool.

Main functions

Random oracle

Provides a random yes/no judgment function to help decide uncertain events in the game

NPC generator

Randomly generates descriptions and characteristics of non - player characters (NPCs)

Event generator

Creates random game events and plot turning points

DM journal

Saves information between game sessions to achieve persistent game state

Advantages

Easy to use, suitable for beginners to learn the MCP protocol

Provides a variety of game auxiliary toolkits

Open - source and can be used for educational purposes

Well - integrated with AI models such as Claude

Limitations

Simple code design, not suitable for production environments

Functions are limited compared to the full - version ChatDM

Requires manual configuration of prompt files

Depends on specific AI model support

How to use

Installation preparation

Ensure that the Java runtime environment and a client supporting MCP (such as the Claude desktop version) are installed

Copy prompt files

Copy the contents of the src/main/easychatdmdir/prompts/ directory to the ~/.easychatdm directory

Start the server

Run the Spring Boot application to start the MCP server

Connect the client

Connect to the locally running server in an MCP client such as the Claude desktop version

Usage examples

Random event decision - making

When unsure whether an NPC will help the player, use the oracle function to get a random answer

Quick NPC generation

Use the NPC generator when you need to temporarily create a town guard character

Frequently Asked Questions

What is the difference between EasyChatDM and ChatDM?

Do I need programming knowledge to use it?

Which AI models are supported?

How to enable the developer mode of Claude?

Related resources

Full - version ChatDM project

A more feature - rich ChatDM project

Teaching video series

Teaching videos on the development process of EasyChatDM

Official website of the MCP protocol

Official documentation of the Model Context Protocol

Plot Unfolding Machine

Some prompt words are based on this CC - licensed system

🚀 EasyChatDM - Example of a Tool for Creating a Simple MCP Server

This is an example of a simple MCP server tool for interacting with generative AI in D&D (Dungeons & Dragons) games. These tools are ".oracle", used to answer random yes/no questions, as well as for descriptions, events, NPCs, etc. They are "random tables" that can be used when you want to introduce some uncertainty, twists, and randomness into the game.

This project is intended for educational purposes, so not much attention has been paid to good code design. Instead, the code is written to make it easy to understand step by step how to create the tools.

These tools are MCP server tools that can be used with Claude Desktop and other MCP clients. They are written using Spring AI MCP. Since this is an educational project, good design is not considered. Instead, the code is written to make it easy to understand step by step how to create the tools.

🚀 Quick Start

You should copy the contents of the src/main/easychatdmdir/prompts/ directory to the ~/.easychatdm directory. These files are used for prompts, divination, etc.

🙏 Acknowledgments

Some divination values and schemes are referenced from the JeansenVaars' Play By Writing system, as well as systems like PUM and GUM.

ℹ️ More Information

Please refer to the ChatDM project, which is a more complex, feature - rich, but better - designed version of EasyChatDM.

Here are some related videos:

Part One: I built a very simple MCP tool world.
In Part Two, I built a file - based divination system, introduced the logs generated by Claude, and showed how to start keeping your own logs.
In Part Three, I created an MCP resource as a DM diary to persist game information between game sessions.
Finally, in Part Four, I finally started making an MCP prompt, which is very exciting. This is the first thing that really feels "agent - like".

Please follow this playlist for more upcoming videos.

📚 References

Enable Developer Mode in Claude Desktop
ChatDM Project - A more complex and feature - rich ChatDM tool with better design and more functions.
Dan Vega's MCP Example
Plot Unfolding Machine - Some prompts are based on JeansenVaar's PUM system, which uses the CC BY - NC - SA 4.0 license.
My Experience of Playing D&D with ChatGPT and Generative AI - Video notes showing how I play D&D with these AIs.