The Fortuneteller's Hand

占卜师之手 — 一款 RPG MCP 服务

一个扮演角色扮演游戏和 GM 的 MCP 服务，采用我目前正在创作的原创桌面 RPG《占卜师之手》的规则。Claude 负责读牌、占卜并主持游戏；玩家和 Claude 将轮流讲述故事的发展。

玩起来是什么感觉

安装之前，先简单介绍一下：你会先与占卜师相会——在什么地方见面，是抽牌前唯一要做的选择。四种花色对应你身上的四个侧面；占卜师从每种花色中抽一张牌，说出牌揭示的内容，而你则根据这四句话塑造角色。 创建好角色后，你必须先解读目标牌，才能踏上旅程。

之后，每个场景都遵循相同的流程：决定身处何处，翻一张牌看看有什么暗流涌动，然后继续叙述。当故事触及另一颗心、某种隐藏之物，或需要运气转折时，就停下来直接向命运求问，呼唤一次预兆。命运也可能与你作对；若真的如此，你可以与之抗争。

本质上，这是一款创意日志游戏。真正的乐趣在于你和占卜师共同构建的叙述，而不在于赢得什么。动机、终点、追寻和携带物并非必须遵守的规则；它们是种子，是角色心理和后续故事形态的四个起点。顺着它们指引的方向走，或者让故事漫游到别处。你描述得越多，故事回馈给你的也越多。

大致就是这样。完整规则见 RULES.md；更轻松、更详尽的玩法指南见 HOW_TO_PLAY.md；实际游戏的一整段对话记录见 08-2026-Play-Example.md。如果你在故事进行途中忘了自己的目标或四个侧面，只要请占卜师提醒你即可。

运行

快速安装

1. 将 fortunetellers-hand-0.1.1.mcpb 下载到一个容易找到的位置。
2. 双击它（不要把它拖进聊天窗口——只需双击文件本身）。这会在 Claude Desktop 中打开安装提示。
3. 确认安装。
4. 完全退出并重新打开 Claude Desktop。
5. 开始新聊天，并调出 start_game 提示词——它会询问角色名称，然后就可以开始了。

从源代码运行

需要 Python 和 uv。

1. 在此目录中运行 uv sync。
2. 在 Claude Desktop 中：Settings → Developer → Edit Config，然后添加：

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

3. 完全退出并重启 Claude Desktop。
4. 点击消息框附近的 + 图标 → Connectors → 启用 "fortuneteller"。
5. 开始新聊天并调出 start_game 提示词。
6. 系统询问角色名称（player_name）时，填写名称。
7. 提示词以标签的形式附加在消息框上方后，点击发送或按 Enter——仅附加提示词不会自动提交。

灵感来源

这个项目汲取了几个来源的灵感。预兆的双骰解读方式——比较点数而非求和——确实深受 Shawn Tomkin 的 Ironsworn 影响，我真的非常喜欢这款游戏。“不该是这样”的抗争仪式，借鉴了 Yahtzee（而 Yahtzee 的玩法又源自波多黎各游戏“Jenerala”）的五颗骰子、三次投掷、保留任意骰子的形式。作为一款日志游戏，本作也深受 Tim Hutchings 的 Thousand Year Old Vampire 影响；它是证明独自游玩、由提示词驱动的游戏也能承载丰富内涵的作品之一。真是了不起的游戏！最后，Max Moon 一直塑造着这个项目的整体基调。我很喜欢 Max Moon 创作的一切。

想了解构建过程吗？

这个项目最初是我为了以自己感兴趣的方式学习 Model Context Protocol 而做的。工具／资源／提示词的选择、状态设计，以及一路发现并修复的几个真实漏洞，都记录在 DESIGN.md 中。如有任何问题，或希望我修复或添加内容，请联系我。

隐私政策

• 数据收集：此 MCP 不收集任何数据。
• 使用和存储：不存储任何内容。所有游戏状态（你的角色、抽到的牌、欠下的债务）仅在会话期间保留在内存中，会话结束后即被丢弃。
• 与第三方共享：由于根本不收集任何数据，因此不会与任何第三方共享。
• 数据保留：不保留任何数据。
• 联系方式：[email protected]