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 分