内容
# Mythx引擎 — 基于MCP的桌面RPG引擎
[](https://github.com/protoLabsAI/mythx-mcp/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/@mythxengine/mcp-server)
[](./LICENSE)
[](#install)
一个完整的桌面RPG引擎，您的AI可以运行：确定性骰子，五层结果，FitD风格的压力，战斗跟踪，情况时钟，调查，NPC关系，世界生成 — 134种工具，基于 <a href="https://modelcontextprotocol.io">模型上下文协议</a>，附带 **四个完整的入门世界**。
克劳德（或任何MCP客户端）成为您的游戏大师。引擎保持规则公正：相同的种子 + 相同的动作 = 相同的结果。
## 安装
### 克劳德代码 — 插件（技能 + 工具，推荐）
```
/plugin marketplace add protoLabsAI/mythx-mcp
/plugin install rpg@mythx-plugins
```
一次安装即可交付MCP服务器和游戏技能（`/rpg:play`，`/rpg:combat-mode`，`/rpg:world-building-mode`等）。
### 克劳德代码 — 仅工具
```bash
claude mcp add rpg -- npx -y @mythxengine/mcp-server
```
需要 Node >= 22.13。
### 克劳德桌面版
从 [最新版本](https://github.com/protoLabsAI/mythx-mcp/releases/latest) 下载 `mythxengine-<version>.mcpb` 并将其拖入 **设置 → 扩展**。无需其他设置 — 克劳德桌面版自带Node运行时。
## 五分钟快速体验
以下所有内容都是安装后与克劳德的对话。首次运行时导入四个世界 — 波特米里亚姆（港口黑色电影），埃塞尔加德（神话前沿），阈值深处（奇怪的深度），以及树屋选集。
**1. 选择一个世界，创建角色。**
> 在波特米里亚姆开始一个会话。我想扮演一个码头维修工，他欠了错误的人钱。
游戏大师调用 `create_session`、`load_world_summary` 和 `create_character` — 您的维修工获得生命值、压力、装备和在世界派系网络中的位置。
**2. 进行有实际风险的掷骰。** 每次测试都以位置（失败有多糟糕？）和效果（成功能获得多少？）为框架：
> 我试图偷偷溜过港口巡逻队到达走私者的快艇。
```
roll_test → 有风险的位置 / 标准效果 → 11 vs 13: 部分成功
" 是的，但是... " — 你到达了快艇，一盏灯笼朝你方向摆动。
游戏大师建议的行动： put_someone_in_spot
```
五种结果 — 关键成功、成功、部分成功、失败、关键失败 — 如果掷骰结果不好，您可以 `push_roll`（花费2点压力获得+1d6）或 `resist_consequence` 降低后果的严重性。压力是一种现实的货币；溢出意味着创伤。
**3. 进行战斗回合。**
> 两个码头工人挡住了 gangway。我拔出我的钩刀。
`start_combat` → `roll_initiative` → `attack` — 追踪出手顺序、护甲、状态和伤害；每次攻击都返回具有建议的游戏大师行动的五层结果。
**4. 观看时钟滴答。** 您躲避的巡逻队呢？游戏大师启动了一个 `harbor-alert` 时钟。 如果失败足够多（`tick_clock` 在部分成功/失败时自动触发），码头灯光就会打开 — 后果按时间表而不是凭空出现。
这就是循环：虚构输入，机制输出，时钟后果。
## 包装内容
| 组件 | 提供内容 |
| ---------------------------------------- | ------------------------------------------------------------------ |
| `packages/mcp-server` | MCP服务器 — 134种工具，以`@mythxengine/mcp-server`发布 |
| `packages/engine` | 纯粹的、种子化的游戏机制（骰子，结果，战斗） |
| `packages/types` / `worlds` / `rulebook` | 每个实体的Zod验证模式，以及规则查询 |
| `packages/storage` | SQLite持久性（`node:sqlite`，零原生依赖） |
| `packages/tools` / `prompts` | 传输无关的工具实现 + 运行时游戏大师技能 |
| `world-builder/` | `rpg`克劳德代码插件（技能，代理，钩子） |
| `agent-kit/` | 便携式游戏大师系统提示和操作手册，适用于**任何**代理 |
| `docs/` | [规则手册](./docs/RULEBOOK.md) + [引擎工作原理](./docs/engine.md) |
| 4个捆绑世界 | ~13 MB的NPC，派系，地点，情况，弧线 — 演示 |
## 规则与文档
- **[docs/RULEBOOK.md](./docs/RULEBOOK.md)** — 完整的规则，所有12章（结果，位置与效果，测试，压力，战斗，状态，装备，时间与时钟，游戏大师行动）。从`packages/rulebook`生成，与`lookup_rule`和`generate_rulebook`工具相同 — 因此它永远不会与引擎分离。
- **[docs/engine.md](./docs/engine.md)** — 引擎工作原理：五层结果系统，位置与效果，压力，确定性随机数生成器，以及各个软件包如何组合。
- **[agent-kit/](./agent-kit/)** — 便携式游戏大师系统提示和操作手册，适用于使用任何代理运行游戏。
## 想要获得完整的体验？
本仓库是引擎。 **MythxEngine 桌面版** 是游戏：一个基于帧的视觉游戏界面，场景图像，生成的世界书籍和润色。 在 [mythxengine.com](https://mythxengine.com) 上关注并在发布时收到通知。
## 开发
```bash
pnpm install
pnpm build && pnpm test && pnpm lint && pnpm typecheck
```
参见 [CONTRIBUTING.md](./CONTRIBUTING.md) — 本仓库是私有 monorepo 的下游镜像；问题是获得修复的最快方式。
## 许可证
[MIT](./LICENSE) © protoLabs Studio
