Holonovel

io.github.flukeatzerocool由 GitHub 账号 flukeatzerocool 发布v2026.11.19更新于 Nov 19, 2026

Holonovel MCP server:桌面角色扮演游戏的世界模型基础(房间、解析器、叙事工具)。

AI 翻译由 AI 模型根据下方的原文描述翻译,可能有误。

原文描述

Holonovel MCP server: world-model base for tabletop RPG play (rooms, parser, narrative tools).

已验证STDIO仅桌面

概览

Holonovel 的本地 MCP 服务;无需登录;STDIO。

暂无 AI 概览:以下信息来自注册中心条目和服务本身。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Holonovel,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

holonovel

The Holodeck for your rulebooks — rules enforced, worlds remembered.

A world-model MCP server for tabletop RPG play: rooms, things, exits, a parser command layer, and narrative tools, with out-of-the-box mechanics from Fate, Ironsworn, and Blades in the Dark (Fudge dice, momentum, and stress tracks — no ruleset required). Install it, then drop in any number of ruleset packages; each loads alongside the base and never modifies it.

Requirements

  • Node.js 22+

Install

sh
npx -y holonovel

A fresh install is playable without a rulebook: the server seeds Torre Nosferatu, a tutorial Novel, and open_session resumes it in one call. Set TTRPG_STARTER_NOVEL=off to start with an empty world instead.

From a source checkout, run npm install and npm run start while developing; for a non-development run, npm run build && node dist/index.js.

MCP client configuration

json
{  "mcpServers": {    "holonovel": {      "command": "npx",      "args": ["-y", "holonovel"]    }  }}

Data

A Novel is a structured save file with atomic saves, per-badge undo/redo snapshots, and an append-only audit log. By default the state directory is the operating system's user-data location: ~/.local/share/holonovel on Linux, ~/Library/Application Support/holonovel on macOS, or %LOCALAPPDATA%\holonovel on Windows. Set TTRPG_DATA_DIR to override it. An existing .holonovel-state/ beside the server is honored for compatibility.

Campaign data and installed packages live under the state directory, outside the server tree, so updating holonovel never touches them. A container or hosted deploy keeps that directory inside the container — point TTRPG_DATA_DIR at a mounted volume to keep campaigns across restarts.

Tool surface

The host exposes 37 action-discriminator tools covering persisted entity types, the parser command layer, and base-mechanics resolvers. Retired tool aliases are hidden from the default listing. Every tool carries all four MCP mutation-class hints and a three-clause description (see AGENTS.md for the full surface and the tool-definition authoring standard).

Categories:

  • Badges & Workflow — badge switching, workflow response, undo/redo
  • Characters & Cast — player characters, NPCs, identity, beliefs
  • World & Scene — world model, scene framing, perception, causal state
  • Narrative — story journal, lore, notes, vows, factions, countdowns
  • Session — recap, health, discovery, event log, audit
  • Mechanics — Fate, Ironsworn, and Forged in the Dark resolvers
  • Content — adventures, codex, ruleset packages, synthesis

Configuration

Behavioral switches read from the environment; every switch is inert by default. Common values:

VariablePurpose
TTRPG_DATA_DIRState directory (default: the per-user data location)
TTRPG_NOVELNovel to activate at startup
TTRPG_SEEDDeterministic PRNG seed
TTRPG_RULESETSRuleset slugs to load eagerly
TTRPG_RULESET_DIRSRuleset install directories
TTRPG_NPC_AUTONOMY, TTRPG_NPC_MINDNPC autonomy behaviors
TTRPG_WORLD_REACTIVITYWorld-in-Motion reactivity (default on)
TTRPG_NARRATION_VALIDATIONNarration grounding validation
TTRPG_GUIDANCE_PROFILEfull or lean guidance

Development

sh
npm run typecheck          # TypeScript type checkingnpm run test:all           # verification harnesses

Tests are tsx harnesses under scripts/ (there is no test/ directory).

License

Canonical origin: git.gay/flukeatzerocool/Holonovel.

Holonovel is MIT-licensed. See LICENSE.md. Built from:

  • D&D 5e SRD v5.2.1 (CC BY 4.0, Wizards of the Coast)
  • Graham Nelson's 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)
  • COF — Character Open File (CC BY 4.0 / CC0 1.0, Yann Souetre)

License texts: CC BY 4.0, CC BY 3.0, CC BY-SA 4.0, CC0 1.0, MIT, Artistic 2.0.

Upstream sources: D&D 5e SRD, Inform, if-craft-corpus, dmcp, lonelog, BitD SRD, Starforged SRD, Lazy GM, The Alexandrian, Dungeon World SRD, Fate SRD, Ironsworn SRD, COF.

RSS. Last updated: 2026-11-17.

来源:holonovel/README.md,提交 1af336f

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

15
  1. v2026.11.19最新Nov 19, 2026
  2. v2026.11.8Nov 11, 2026
  3. v2026.11.7Nov 7, 2026
  4. v2026.10.31Nov 1, 2026
  5. v2026.10.26Oct 29, 2026
  6. v2026.10.25Oct 25, 2026
  7. v2026.10.22Oct 22, 2026
  8. v2026.10.12Oct 12, 2026
  9. v2026.10.9Oct 9, 2026
  10. v2026.10.3Oct 3, 2026
  11. v2026.9.30Sep 30, 2026
  12. v2026.9.29Sep 30, 2026
  13. v2026.9.28Sep 28, 2026
  14. v2026.9.27Sep 27, 2026
  15. v2026.9.7Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分