
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).
概覽
Holonovel 的本機 MCP 服務;無需登入;STDIO。
暫無 AI 概覽:以下資訊來自註冊中心條目和服務本身。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Holonovel,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
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
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
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:
Development
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版本歷史
15- v2026.11.19最新Nov 19, 2026
- v2026.11.8Nov 11, 2026
- v2026.11.7Nov 7, 2026
- v2026.10.31Nov 1, 2026
- v2026.10.26Oct 29, 2026
- v2026.10.25Oct 25, 2026
- v2026.10.22Oct 22, 2026
- v2026.10.12Oct 12, 2026
- v2026.10.9Oct 9, 2026
- v2026.10.3Oct 3, 2026
- v2026.9.30Sep 30, 2026
- v2026.9.29Sep 30, 2026
- v2026.9.28Sep 28, 2026
- v2026.9.27Sep 27, 2026
- v2026.9.7Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分