使用说明
RPG MCP服务器
一个简单的MCP(模型上下文协议)服务器,用于播放具有大型语言模型的RPG。它提供了掷骰子、成功检查和随机事件生成的工具。
特性
check_success(probability, critical_rate)-使用可选的关键结果确定成功/失败roll_dice(expr)-使用标准RPG符号掷骰子(例如“1d6”、“2d8+3”)generate_event()-为情节转折和惊喜生成随机RPG事件list_tools()-列出所有可用工具
安装
先决条件
- Python 3
- 紫外线 -一个快速的Python包安装程序
设置
- 克隆存储库:
git clone https://github.com/jnaskali/rpg-mcp.git
cd rpg-mcp
- 使用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是否产生了幻觉。