Skip to main content
MCP server CX Codex

dsh-novel-forge — Claude Code MCP server: what it does, how to install

dsh-novel-forge is a Claude Code MCP server that structures long-form fiction writing across 24 tools. It validates scene contracts and blocks plot contradictions before text hits the disk.

MIT ★ 50 updated 2026-11-17

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add dsh-novel-forge -e NOVEL_FORGE_ROOT=<NOVEL_FORGE_ROOT> -- npx -y dsh-novel-forge
Open on GitHub

What dsh-novel-forge does

The server provides 24 tools under the novel_* prefix to manage long-form novel projects. A deterministic nine-stage state machine guides work from premise, world setting, and character sheets to scene outlines and chapter drafts. It enforces consistency through novel_ledger, rejecting contradictory status changes within the same chapter instead of silently overwriting them.

All consistency checks run locally with zero token consumption. The novel_audit tool scans for timeline gaps, character contradictions, and unresolved foreshadowing. If a single chapter gets rejected three times consecutively by validation gates, a circuit breaker halts drafting until the scene outline is revised.

Execution requires Node 20 or higher, with Node 22 recommended for search indexing. The project directory must be specified via the NOVEL_FORGE_ROOT environment variable.

What it helps with

  • enforce worldbuilding consistency across long serialized chapters
  • audit novel drafts for plot discrepancies without token costs
  • guide manuscript development through a structured nine-stage pipeline
  • prevent silent character and inventory overwrites in story progression

Example prompts for the agent

  • Initialize a new fantasy book project using novel_project init.
  • Run novel_audit to scan the entire manuscript for character contradictions.
  • Generate the context package for the upcoming chapter using novel_briefing.

How to install dsh-novel-forge

Platform CLI

claude mcp add dsh-novel-forge -e NOVEL_FORGE_ROOT=<NOVEL_FORGE_ROOT> -- npx -y dsh-novel-forge

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about dsh-novel-forge

How to install dsh-novel-forge in Claude Code?

Run claude mcp add dsh-novel-forge -e NOVEL_FORGE_ROOT=<NOVEL_FORGE_ROOT> -- npx -y dsh-novel-forge in your terminal.

What does dsh-novel-forge do?

It provides 24 structured tools for novel writing, enforcing strict consistency gates, outline compliance, and local manuscript audits.

What is required to run dsh-novel-forge?

You need Node 20 or newer and the NOVEL_FORGE_ROOT environment variable configured with your novel directory path.

Similar MCP servers

All MCP servers for Writing and docs →

Project sponsors

Companies that keep this analytics open