RPG游戏服务器

一个简单的MCP服务器,用于与大型语言模型一起玩RPG游戏,提供骰子滚动、成功检查和随机事件生成工具。

  • by jnaskali
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 jnaskali/rpg-mcp

使用说明

RPG MCP服务器

一个简单的MCP(模型上下文协议)服务器,用于播放具有大型语言模型的RPG。它提供了掷骰子、成功检查和随机事件生成的工具。



特性

  • check_success(probability, critical_rate) -使用可选的关键结果确定成功/失败
  • roll_dice(expr) -使用标准RPG符号掷骰子(例如“1d6”、“2d8+3”)
  • generate_event() -为情节转折和惊喜生成随机RPG事件
  • list_tools() -列出所有可用工具

安装

先决条件

  • Python 3
  • 紫外线 -一个快速的Python包安装程序

设置

  1. 克隆存储库:
git clone https://github.com/jnaskali/rpg-mcp.git
cd rpg-mcp
  1. 使用uv安装依赖项:
uv sync

配置

将以下内容添加到MCP客户端的配置文件中(例如。, mcp.json 在Claude Desktop或其他MCP兼容客户端中):

{
  "mcpServers": {
    "rpg-mcp": {
      "command": "/usr/bin/uv",
      "args": [
        "run",
        "python",
        "app.py"
      ],
      "cwd": "/PATH_TO/rpg-mcp/"
    }
  }
}

替换 /PATH_TO/rpg-mcp/ 带有rpgmcp目录的实际路径。

用法

配置后,LLM可以调用这些工具:

  • 掷骰子进行攻击、伤害或技能检查
  • 使用可定制的成功概率确定行动结果
  • 生成随机事件以推动叙事向前发展

示例提示

在提示中包含以下说明:

每当玩家角色尝试有可能失败的事情时,调用check_success,并在新场景开始时或移动到新位置时生成一个随机事件generate_envent

事件生成系统的灵感来自 神话游戏大师模拟器.

[!重要]
工具调用最适合支持函数调用的模型,如Claude、GPT-4、Mistral、Llama或Qwen。

示例

通过要求LLM生成随机事件来测试服务器。独特的格式应明确工具是否正常工作,或者LLM是否产生了幻觉。