RPG Generator MCP Server

RPG 生成器 MCP 服务

一个用于生成随机桌面 RPG 内容（战役创意和奇幻地区属性）的 Model Context Protocol（MCP）服务，使用 TypeScript 和官方 MCP SDK 构建。

这是什么？

本项目演示如何构建一个简单的 Model Context Protocol（MCP） 服务，让大模型可以用它生成随机桌面 RPG 内容。

MCP 是一项开放标准，为 AI 模型连接专业工具和数据源提供了通用方式。通过实现 MCP 规范，本服务可以让大模型生成随机战役创意和奇幻地区属性，通过促成无关元素之间的联系，激发创造力。

本服务提供两项主要功能：

• random_campaign_idea - 通过组合角色类型、背景设定和电影灵感，生成随机战役创意
• random_region_attributes - 为奇幻世界构建生成随机地区标签、人口等级和人口特征

为什么使用随机生成器？

正如游戏主持人会使用随机表，通过促成看似无关元素之间的联系来激发创造力，大模型也可以借助随机输入摆脱可预测的模式。本项目演示如何通过连接专业工具，利用 MCP 拓展大模型的创造能力。

开始使用

先决条件

• Node.js
• npm

安装

1. 克隆仓库：

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

2. 安装依赖：

npm install

3. 构建并安装：

npm run build

使用 MCP 服务

使用 Claude

1. 在 Claude 桌面应用中打开 Claude

2. 前往 Settings，选择 Developer，然后点击 Edit Config 按钮。这会打开包含 claude_desktop_config.json 文件的文件夹。

3. 将服务添加到 JSON 文件中：

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

4. 退出并重新启动 Claude Desktop。
5. 现在，你可以让 Claude 生成随机战役创意或地区属性。

提示词示例：

• “为我的 TTRPG 生成一个随机战役创意”
• “我需要一些奇幻世界中的随机地区”

功能参考

random_campaign_idea

参数：无

响应：描述战役创意的字符串，内容组合了：

• 角色类型（例如，“雇佣兵”“越狱囚犯”“运动员”）
• 背景设定（例如，“妖精荒野”“机甲”“都市奇幻”）
• 电影灵感（例如，《侏罗纪公园》《公主新娘》《异形》）

响应示例：

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

random_region_attributes

参数：无

响应：Markdown 格式的字符串，包含：

• 地区标签（2 个随机标签及其描述）
• 人口等级（聚居地的密度和规模）
• 人口特征（文化或社会特征）

响应示例：

**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.

扩展服务

本项目可以轻松扩展，添加更多随机生成器。添加自定义生成器的方法：

1. 参照现有生成器和现有生成器创建一个新的生成器函数。
2. 在 mcp-server.ts 中将生成器添加为工具。
3. 构建

如果想在不构建和安装的情况下测试 MCP 服务，可以使用 MCP Inspector：

npm run inspect

致谢

• 使用官方的 Model Context Protocol SDK 构建
• 实现了 Model Context Protocol 规范
• 灵感源自无数小时的桌面 RPG 乐趣