
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 分