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
claude mcp add dsh-novel-forge -e NOVEL_FORGE_ROOT=<NOVEL_FORGE_ROOT> -- npx -y dsh-novel-forgeWhat 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_auditto 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-forgeReplace <…> with your own values
Platform CLI
codex mcp add dsh-novel-forge --env NOVEL_FORGE_ROOT=<NOVEL_FORGE_ROOT> -- npx -y dsh-novel-forgeReplace <…> with your own values
Config file
{
"mcpServers": {
"dsh-novel-forge": {
"command": "npx",
"args": [
"-y",
"dsh-novel-forge"
],
"env": {
"NOVEL_FORGE_ROOT": "<NOVEL_FORGE_ROOT>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"dsh-novel-forge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"dsh-novel-forge"
],
"env": {
"NOVEL_FORGE_ROOT": "<NOVEL_FORGE_ROOT>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e NOVEL_FORGE_ROOT=<NOVEL_FORGE_ROOT> dsh-novel-forge npx -y dsh-novel-forgeReplace <…> 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.