命运之手 — 一款 RPG MCP 服务器

一个 MCP 服务器，利用命运之手的规则扮演角色扮演游戏和游戏主持人，命运之手是我正在创作的一款原创桌上角色扮演游戏。Claude 负责读牌、施展预兆、主持游戏；玩家与 Claude 轮流叙述逐渐展开的故事。

游戏体验

简而言之，在你安装任何东西之前：你首先与命运师对坐——你与命运师相遇的地点，就是抽牌之前你唯一需要做出的选择。四种花色对应你性格的四个侧面；命运师从每种花色中各抽一张牌，并解读其含义，你便依据这四句话塑造你的角色。

角色成型后，你还必须解读你的目标牌，然后才能踏上旅途。

此后，每个场景都以同样的方式进行：决定你身在何处，翻一张牌看看有何动静，然后继续叙述。当故事触及另一颗心、某个隐秘之物，或需要命运垂青时，你便停下，直接召唤命运——呼唤预兆。但命运也可能反噬于你；当它降临时，你可以奋起抗争。

归根结底，这是一款创意写作游戏。真正的乐趣在于你和命运师共同编织的叙述，而非输赢。动机、结局、追寻、背负——这些不是规则，而是种子，是你角色心理的四个起点，也是故事走向的四个方向。跟随它们，或让故事自行漂泊——你描述得越多，故事回馈得也越多。

这就是游戏的全貌。完整机制见 RULES.md；更温和的入门指南见 HOWTO_PLAY.md；一场完整对局的实录见 08-2026-Play-Example.md。如果你在故事中途忘记了你的目标或四个侧面，只需请命运师提醒你即可。

Related MCP server: mcp-tarot-draw

运行方式

快速安装

1. 将 learnMCP.mcpb 保存到容易找到的位置。

2. 双击它（不要把它拖进聊天窗口——直接双击文件本身）。它会在 Claude Desktop 中打开安装提示。

3. 确认安装。

4. 完全退出并重新打开 Claude Desktop。

5. 开启一个新对话，调用 start_game 提示词——它会询问你的角色名字，然后你就可以开始了。

从源码运行

需要 Python 和 uv。

1. 在此目录内运行 uv sync。

2. 在 Claude Desktop 中：设置 → 开发者 → 编辑配置，然后添加：

   {
     "mcpServers": {
       "fortuneteller": {
         "command": "uv",
         "args": ["run", "--directory", "/absolute/path/to/learnMCP", "main.py"]
       }
     }
   }

3. 完全退出并重新启动 Claude Desktop。

4. 点击消息框附近的 + 图标 → 连接器 → 启用 "fortuneteller"。

5. 开启一个新对话，调用 start_game 提示词。

6. 当它询问你的角色名字（player_name）时，填写即可。

7. 提示词作为消息框上方的附件出现后，点击发送或按回车——附件本身不会自动提交。

灵感来源

这个项目借鉴了几个地方。双骰解读（比较而非相加）深深受惠于 Shawn Tomkin 的 Ironsworn，我由衷喜爱。而"绝不如此"的抗拒仪式，其五骰三留的取舍形态则借自波多黎各游戏 "Jenerala"（即 Yahtzee）。作为一款日记体游戏，它很大程度上归功于 Tim Hutchings 的 Thousand Year Old Vampire——它证明了单人、提示驱动的游玩可以承载真正的分量。最后，Max Moon 在整个项目中塑造了它的基调，我崇拜他创作的一切。

关于构建过程？

这是为了以我感兴趣的方式学习 Model Context Protocol。工具/资源/提示词的选择、状态设计、以及一路走来遇到并修复的几个真实 bug，都记录在 DESIGN.md 中。如有任何问题，或希望我修复或补充什么，请随时联系我。

隐私政策

• 数据收集：本 MCP 不收集任何数据。

• 使用与存储：不存储任何内容。所有游戏状态（你的角色、抽到的牌、欠下的债）仅存在于当前会话的内存中，会话结束即被丢弃。

• 第三方共享：不向任何第三方共享任何内容，因为根本没有任何内容被收集。

• 数据保留：不保留任何数据。

• 联系方式：maria@mariasaha.com