RPG Generator MCP Server

Created By

guyroyse8 months ago

Content

RPG Generator MCP Server

A Model Context Protocol (MCP) server that generates random tabletop RPG content—campaign ideas and fantasy region attributes—built with TypeScript using the official MCP SDK.

What is this?

This project demonstrates how to build a simple Model Context Protocol (MCP) server that LLMs can use to generate random tabletop RPG content.

MCP is an open standard that provides a common way for AI models to connect with specialized tools and data sources. By implementing the MCP specification, this server allows LLMs to generate random campaign ideas and fantasy region attributes, which can help spark creativity by forcing connections between unrelated elements.

The server offers two main functions:

random_campaign_idea - Generates a random campaign idea by combining character types, settings, and movie inspirations
random_region_attributes - Generates random region tags, population levels, and population characteristics for fantasy world-building

Why Random Generators?

Just like gamemasters use random tables to spark creativity by forcing connections between seemingly unrelated elements, LLMs can break out of predictable patterns with randomized inputs. This project demonstrates how MCP can be used to extend an LLM's creative capabilities through specialized tool connections.

Getting Started

Prerequisites

Node.js
npm

Installation

Clone the repository:

git clone https://github.com/guyroyse/rpg-generator-mcp-server.git
cd rpg-generator-mcp-server

Install dependencies:

npm install

Build and install:

npm run build

Using the MCP Server

With Claude

Open Claude in the Claude Desktop app
Go to Settings, select Developer, and click on the Edit Config button. This will open the folder that contains your claude_desktop_config.json file.
Add the server to the JSON file:

{
  "mcpServers": {
    "rpg-generator": {
      "command": "rpg-generator-mcp-server"
    }
  }
}

Exit and restart Claude Desktop.
Now, you can ask Claude to generate random campaign ideas or region attributes.

Example prompts:

"Generate a random campaign idea for my TTRPG"
"I need some random regions for my fantasy world"

Function Reference

`random_campaign_idea`

Parameters: None

Response: A string describing a campaign idea that combines:

Character types (e.g., "Mercenaries", "Escaped Prisoners", "Athletes")
Settings (e.g., "Feywild", "Mecha", "Urban Fantasy")
Movie inspirations (e.g., "Jurassic Park", "The Princess Bride", "Aliens")

Example response:

The players are Escaped Prisoners adventuring in a Mecha setting experiencing events similar to the movie Jurassic Park.

`random_region_attributes`

Parameters: None

Response: A markdown-formatted string containing:

Region Tags (2 random tags with descriptions)
Population Level (density and size of settlements)
Population Characteristic (cultural or societal trait)

Example response:

**Region Tags**
Feral Magic: Region where magic has become untamed and manifests as semi-sentient predatory phenomena.
Monastic Retreat: Area dotted with monasteries and meditation sites, often with unique fighting or magical traditions.

**Population Level**
Outpost: A tiny settlement of 10-50 individuals, possibly a trading post, watchtower, research station, or religious retreat. Extremely isolated with minimal facilities.

**Population Characteristic**
Military Tradition: Martial skills are highly valued, with many citizens receiving combat training regardless of their primary occupation. This might stem from a history of conflict, strategic location, or cultural values. Martial accomplishments bring prestige, and military leaders often hold political authority as well.