mcpField
H
holonovel

holonovel

本地服务
github.com/flukeatzerocool游戏娱乐02 天前更新
代码仓库

关于 holonovel

holonovel 是用于桌面角色扮演游戏的世界模型 MCP 服务，适合需要结构化战役状态和规则支持的玩家团体。它结合命令解析器、叙事工具、持久化存档和内置机制，并允许添加规则集包。

主要功能

  1. 01建模房间、物件和出口
  2. 02管理角色、场景和战役设定
  3. 03命令解析层与叙事工具
  4. 04内置 Fate、Ironsworn 和 Blades in the Dark 机制
  5. 05持久化存档、撤销重做和审计日志

适用场景

  1. 01追踪桌面角色扮演游戏世界
  2. 02在游戏过程中结算支持的规则机制
  3. 03跨场次保存战役笔记和事件

MCP 相关

向 MCP 客户端提供 36 个按动作区分的工具，用于管理世界实体、解析命令、处理战役工作流和叙事内容，以及使用内置机制。规则集包可与基础服务一同加载。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "flukeatzerocool-holonovel": {
      "command": "npx",
      "args": [
        "-y",
        "holonovel"
      ]
    }
  }
}
启动命令npx -y holonovel

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmholonovel2026.10.26

工具

30

收录的工具列表 · 更新于 1 天前

参数类型必填说明
badgeenum是要激活的徽章：player、game_master、observer 或 none（Editor）。player | game_master | observer | none

详细介绍

holonovel

你的规则手册全息甲板——规则得到执行，世界得以铭记。

用于桌面 RPG 游戏的世界模型 MCP 服务：包含房间、物件、出口、解析器命令层和叙事工具，并内置 Fate、Ironsworn 和 Blades in the Dark 的机制（Fudge 骰子、势头和压力轨道——无需指定规则集）。安装后即可添加任意数量的规则集包；每个规则集包都会与基础内容一同加载，且不会修改基础内容。

要求

  • Node.js 22+

安装

npx -y holonovel

从源代码检出目录运行 npm install 和 npm run start。

MCP 客户端配置

"holonovel": {
  "type": "local",
  "command": ["npx", "-y", "holonovel"],
  "enabled": true
}

数据

Novel 是一个结构化存档文件，支持原子保存、按徽章区分的撤销／重做快照，以及仅追加的审计日志。默认情况下，状态目录位于操作系统的用户数据目录：Linux 上为 ~/.local/share/holonovel，macOS 上为 ~/Library/Application Support/holonovel，Windows 上为 %LOCALAPPDATA%\holonovel。设置 TTRPG_DATA_DIR 可覆盖此位置。为兼容性，服务器旁现有的 .holonovel-state/ 目录仍会被采用。

战役数据和已安装的包位于服务器目录之外的状态目录中，因此更新 holonovel 不会触及它们。

工具概览

宿主提供 36 个操作判别器工具，涵盖持久化实体类型、解析器命令层和基础机制解析器。默认列表中会隐藏已弃用的工具别名。每个工具都包含全部四种 MCP mutation-class 提示，以及由三个子句组成的描述（完整概览和工具定义编写规范见 AGENTS.md）。

类别：

  • 徽章与工作流 — 徽章切换、工作流响应、撤销／重做
  • 角色与演出阵容 — 玩家角色、NPC、身份、信念
  • 世界与场景 — 世界模型、场景构建、感知、因果状态
  • 叙事 — 故事日志、背景设定、笔记、誓言、派系、倒计时
  • 会话 — 回顾、状态、发现、事件日志、审计
  • 机制 — Fate、Ironsworn 和 Forged in the Dark 解析器
  • 内容 — 冒险、资料集、规则集包、综合整理

配置

行为开关从环境变量读取；默认情况下所有开关均不生效。常用值：

变量用途
TTRPG_DATA_DIR状态目录（默认：每位用户的数据位置）
TTRPG_NOVEL启动时激活的 Novel
TTRPG_SEED确定性 PRNG 种子
TTRPG_RULESETS立即加载的规则集 slug
TTRPG_RULESET_DIRS规则集安装目录
TTRPG_NPC_AUTONOMY、TTRPG_NPC_MINDNPC 自主行为
TTRPG_WORLD_REACTIVITY世界动态反应能力（默认开启）
TTRPG_NARRATION_VALIDATION叙事内容依据验证
TTRPG_GUIDANCE_PROFILEfull 或 lean 指导模式

开发

npm run typecheck          # TypeScript type checking
npm run test:all           # verification harnesses

测试是位于 scripts/ 下的 tsx 测试框架（没有 test/ 目录）。

许可证

MIT。请参阅 LICENSE.md。

随附的机制和规则集智慧内容基于：

  • D&D 5e SRD v5.1（CC BY 4.0 + OGL 1.0a，Wizards of the Coast）
  • Graham Nelson 的 Inform（Artistic License 2.0，Graham Nelson）
  • if-craft-corpus（CC BY 4.0，pvliesdonk）
  • dmcp（MIT，Shawn Rushefsky）
  • lonelog（CC BY-SA 4.0，zeruhur）
  • BitD SRD（CC BY 3.0，John Harper）
  • Ironsworn: Starforged SRD（CC BY 4.0，Shawn Tomkin）
  • Sly Flourish Lazy GM Resource Document（CC BY 4.0，Mike Shea）
  • The Alexandrian（CC BY 4.0，Justin Alexander）
  • Dungeon World SRD（CC BY 3.0，Sage LaTorra、Adam Koebel）
  • Fate SRD（CC BY 3.0，Evil Hat Productions）
  • Ironsworn SRD（CC BY 4.0，Shawn Tomkin）

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。