novel-writer-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_ROOT | Yes | Path to the novel-writer-mcp repository | |
| WRITING_ROOT | Yes | Path to your novel data directory |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_projectB | 从 profile 模板初始化小说项目目录 |
| list_projectsA | 列出所有小说项目 |
| get_projectA | 读取项目配置与 pacing |
| update_project_pacingC | 更新项目节奏参数 |
| split_chapter_to_scenesB | 将某章拆为 N 个 scene，自动分配 checklist（按 chapter.kind 过滤） |
| update_chapterB | 更新章节 title/kind；kind 变更默认不重写已有 checklist，可选 rebuild_checklists |
| update_sceneC | 更新场景的 goal/conflict/change/checklist 勾选 |
| close_sceneB | 标记场景完成，写入 change，可选关联伏笔 |
| get_scene_checklistA | 返回场景 checklist 及章级聚合校验（缺爽点/缺章末钩子） |
| get_chapter_checklistC | 整章 checklist + pacing 校验 + 伏笔到期 issues |
| list_profilesA | 列出 profiles/*.json 可用模板 |
| register_foreshadowD | 登记伏笔 |
| get_open_foreshadowsB | 查询开放中的伏笔（含 chapters_since_hint） |
| pay_off_foreshadowB | 标记伏笔已回收（status: closed） |
| hint_foreshadow_againC | 再次暗示伏笔，关联 scene 并更新 last_hinted_chapter |
| get_foreshadows_dueA | 返回 planned_payoff_chapter <= 当前章号且未 closed 的伏笔 |
| import_drawio_outlineA | 解析 .drawio XML，按节点标签生成 arc/chapter/scene 骨架 |
| suggest_next_scenesB | 基于 advance_operators 与上一场 change 输出候选场景，支持 constraints 过滤 |
| export_chapter_prdB | 导出章节 PRD 到 .taskmaster/docs/ 供 Task Master parse_prd 使用 |
| link_scene_manuscriptB | 设置 scene.prose_path，可选自动统计 word_count |
| get_scene_prose_summaryC | 读取正文前 N 字 + 轻量校验 goal/change 关键词是否出现 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 21 tools
Every tool targets a distinct resource/action: project CRUD+pacing, chapter/scene editing, foreshadow lifecycle, import/export, and manuscript linking. No two tools appear to do the same thing; even similar getters differ by scope (scene vs chapter, open vs due foreshadows).
All tool names use snake_case with a consistent verb_noun pattern (create_project, get_scene_checklist, pay_off_foreshadow). Minor variation like 'hint_foreshadow_again' still follows the same verb-first convention and remains predictable.
21 tools is on the heavier side but justified by the multi-faceted domain (project setup, chapter/scene management, foreshadowing, import/export). Each tool has a specific role, so the count does not feel bloated.
Covers the full novel-writing workflow: project initialization, chapter/scene breakdown, checklist validation, foreshadow tracking, outline import, and PRD export. Minor gaps like delete/archive operations are absent but not critical for the core creative process.