RPG生成器MCP服务器

这是一个使用TypeScript和官方MCP SDK构建的Model Context Protocol (MCP)服务器，用于生成随机桌面RPG内容——战役想法和幻想地区属性。

这是什么？

该项目展示了如何构建一个简单的Model Context Protocol (MCP)服务器，LLMs可以使用它来生成随机桌面RPG内容。

MCP是一个开放标准，提供了一种通用方式让AI模型与专用工具和数据源连接。通过实现MCP规范，此服务器允许LLMs生成随机战役想法和幻想地区属性，这可以帮助激发创造力，通过强制连接看似不相关的元素。

该服务器提供了两个主要功能：

• random_campaign_idea - 通过结合角色类型、设置和电影灵感来生成随机战役想法
• random_region_attributes - 为幻想世界构建生成随机区域标签、人口水平和人口特征

为什么是随机生成器？

就像游戏主持人使用随机表格通过强制连接看似不相关的元素来激发创造力一样，LLMs可以通过随机输入打破可预测的模式。本项目演示了如何利用MCP扩展LLM的创意能力，通过与专用工具的连接。

开始使用

先决条件

• 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 Desktop应用中打开Claude
2. 前往设置，选择开发者，并点击编辑配置按钮。这将打开包含您的claude_desktop_config.json文件的文件夹。
3. 将服务器添加到JSON文件中：

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

4. 退出并重新启动Claude Desktop。
5. 现在，您可以要求Claude为您生成随机战役想法或地区属性。

示例提示：

• "为我的TTRPG生成一个随机战役想法"
• "我需要一些随机区域来构建我的幻想世界"

函数参考

random_campaign_idea

参数：无

响应：描述战役想法的字符串，结合了：

• 角色类型（例如，“雇佣兵”，“逃犯”，“运动员”）
• 设置（例如，“费伊威尔”，“机甲”，“都市奇幻”）
• 电影灵感（例如，“侏罗纪公园”，“公主新娘”，“异形”）

示例响应：

玩家是一群逃犯，在机甲设定中冒险，经历类似于电影《侏罗纪公园》中的事件。

random_region_attributes

参数：无

响应：包含以下内容的markdown格式字符串：

• 区域标签（2个随机标签及其描述）
• 人口水平（定居点的密度和规模）
• 人口特征（文化或社会特质）

示例响应：

**区域标签**
野蛮魔法：魔法变得无法驯服，以半智能捕食现象的形式出现的区域。
修道院避难所：遍布修道院和冥想场所的区域，通常具有独特的战斗或魔法传统。

**人口水平**
前哨站：一个只有10-50人的小型定居点，可能是贸易站、瞭望塔、研究站或宗教避难所。极其孤立，设施有限。

**人口特征**
军事传统：武术技能受到高度重视，许多市民无论其主要职业为何都会接受战斗训练。这可能源于冲突的历史、战略位置或文化价值观。军事成就带来荣誉，军事领导人往往也拥有政治权威。

扩展服务器

这个项目可以轻松地通过添加额外的随机生成器进行扩展。要添加自己的生成器：

1. 创建一个新的生成器函数，模仿现有的campaign-generator.ts和region-generator.ts。
2. 在mcp-server.ts中将生成器作为工具添加。
3. 构建

如果您想要测试MCP服务器而不必构建和安装，可以使用MCP Inspector：

npm run inspect

致谢

• 使用官方Model Context Protocol SDK构建
• 实现了Model Context Protocol规范
• 受益于无数小时的桌面RPG乐趣