MCP Novel Assistant 小说创作助手

这是一个基于MCP (Model Context Protocol) 官方SDK的专业小说创作助手项目，采用模块化架构设计，为AI小说创作提供全方位的辅助功能。

NPM 仓库地址: @zb2947244682/mcp-novel-assistant

项目特点

• 专业创作指导: 提供完整的小说架构体系和创作指导
• 模块化架构: 每个功能模块独立成文件，便于维护和扩展
• MCP规范: 完全符合MCP官方SDK规范
• 中文支持: 提供中文界面和详细的使用指南
• 资源模板: 支持动态URI资源访问
• 错误处理: 完善的错误处理和用户提示
• 多种小说类型: 支持玄幻、都市、科幻等多种小说类型

项目结构

MCP工具项目结构

mcp-novel-assistant/
├── index.js                    # 主入口文件，负责启动服务器
├── registrar.js                # 注册器，管理所有组件的注册
├── tools/                      # 工具模块目录
│   ├── novelInitTool.js        # 小说初始化工具实现
│   └── novelContinueTool.js    # 小说续写工具实现
├── resources/                  # 资源模块目录
│   ├── configResource.js       # 配置资源
│   ├── historyResource.js      # 历史记录资源
│   └── helpResource.js         # 帮助资源
├── prompts/                    # 提示词模块目录
│   ├── novelStylePrompt.js     # 小说风格提示词
│   ├── novelInitPrompt.js      # 小说初始化提示词
│   └── novelContinuePrompt.js  # 小说续写提示词
├── utils/                      # 工具方法目录
│   ├── novelUtils.js           # 小说相关工具方法
│   └── dataUtils.js            # 数据生成工具方法
├── Assistant/                  # 助手文档目录
│   ├── 小说创作初始化指南.md    # 详细的小说初始化指南
│   └── 小说续写指南.md         # 详细的小说续写指南
└── README.md                   # 项目说明文档

生成的小说文件结构（固定格式）

我的小说/（或用户指定的路径）
├── 故事圣经.md                 # 核心设定文件
├── 角色/                        # 角色档案目录
│   ├── 主角/                    # 主角目录
│   │   └── [角色名].md          # 每个主角单独文件
│   ├── 配角/                    # 配角目录
│   │   └── [角色名].md          # 每个配角单独文件
│   └── 反派/                    # 反派目录
│       └── [角色名].md          # 每个反派单独文件
├── 大纲/                        # 大纲设计目录
│   ├── 总体架构.md              # 整体故事结构
│   ├── 分卷/                    # 分卷设计目录
│   │   ├── 第一卷_[7字标题].md  # 分卷文件（标题必须7字）
│   │   ├── 第二卷_[7字标题].md
│   │   ├── 第三卷_[7字标题].md
│   │   └── 第四卷_[7字标题].md
│   └── 章节大纲/                # 章节大纲目录
│       └── 第XXX章_[7字标题].md # 每章单独文件（标题必须7字）
├── 章节/                        # 正式章节内容目录
│   ├── 第001-050章/             # 第1-50章目录
│   │   └── 第XXX章_[7字标题].md # 章节文件（标题必须7字）
│   ├── 第051-100章/             # 第51-100章目录
│   │   └── 第XXX章_[7字标题].md
│   ├── 第101-150章/             # 第101-150章目录
│   │   └── 第XXX章_[7字标题].md
│   └── ...                      # 按50章一组继续
├── 管理/                        # 创作管理目录
│   ├── 创作日志.md              # 创作思路记录
│   ├── 角色进化.md              # 角色发展轨迹
│   ├── 情感地图.md              # 情感强度分布
│   ├── 象征词典.md              # 象征符号词典
│   ├── 文风指南.md              # 文风标准指导
│   ├── 质量指标.md              # 质量评估标准
│   └── 故事总结.md              # 章节总结归档
├── 草稿/                        # 草稿目录
│   └── [临时文件].md            # 实验性写作
└── 研究/                        # 参考资料目录
    └── [资料文件].md            # 背景研究资料

文件命名规范

1. 分卷命名：第X卷_[7字标题].md（标题必须恰好7个字，除非用户特别要求）
2. 章节命名：第XXX章_[7字标题].md（章节号用3位数字，标题必须恰好7个字）
3. 角色命名：[角色名].md（使用角色的正式名称）
4. 章节目录：每50章一个目录，格式为第XXX-XXX章/

标题长度要求

• 分卷标题：必须恰好7个字（如：新世界的曙光）
• 章节标题：必须恰好7个字（如：命运的邂逅时）
• 特别说明：除非用户明确要求其他长度，否则严格执行7字标题规范

功能模块

工具 vs 提示词的区别

本项目提供了两种功能实现方式：

Tools（工具）：

• 直接返回处理结果
• 适合需要复杂逻辑处理的场景
• 返回格式为 content 对象
• 实际使用方式：大模型在对话中自动调用

Prompts（提示词）：

• 返回结构化的提示词消息
• 适合需要与大模型交互的场景
• 返回格式为 messages 数组，包含 role 和 content
• 实际使用方式：大模型在对话中自动调用

1. 小说初始化工具 (novel_init)

• 创建完整的小说架构
• 支持多种小说类型（玄幻、都市、科幻等）
• 生成详细的人物设定、世界观设定
• 提供完整的故事大纲和章节规划
• 使用方式：在大模型对话中提供创作需求，大模型自动调用

2. 小说续写工具 (novel_continue)

• 基于已有内容进行高质量章节续写
• 保持人物性格和故事连贯性
• 支持多种写作风格和节奏控制
• 提供情节发展和冲突设计建议
• 使用方式：在大模型对话中提供续写需求，大模型自动调用

3. 小说风格提示词 (novel-style)

• 个性化写作风格指导
• 支持不同文学流派和写作技巧
• 提供语言风格和表达方式建议
• 使用方式：大模型在需要时自动调用

4. 小说初始化提示词 (novel_init_prompt)

• 生成专业的小说架构创建提示词
• 支持多种小说类型和创作需求
• 提供完整的文件组织结构指导
• 使用方式：大模型在需要时自动调用

5. 小说续写提示词 (novel_continue_prompt)

• 生成精准的章节续写提示词
• 保持人物性格和故事连贯性
• 提供详细的创作标准和质量要求
• 使用方式：大模型在需要时自动调用

6. 配置资源 (config://novel-assistant)

• 服务器基本信息
• 支持的功能列表
• 资源模板说明

7. 历史记录资源 (history://{operation}/{type}/{id})

• 动态URI模板
• 创作历史示例
• 写作技巧提示

8. 帮助资源 (help://resource-templates)

• Resource Template使用说明
• 详细的使用示例和最佳实践

⚙️ 配置说明

在 Cursor 中配置

将以下配置添加到您的 Cursor mcp.json 文件中：

{
  "mcp-novel-assistant": {
    "command": "npx",
    "args": [
      "-y",
      "@zb2947244682/mcp-novel-assistant@latest"
    ]
  }
}

通过 npx 直接运行

您可以通过以下命令直接从命令行运行此 MCP 项目：

npx @zb2947244682/mcp-novel-assistant@latest

本地开发配置

如果您在本地开发环境中使用，可以将以下配置添加到您的 Cursor mcp.json 文件中：

{
  "mcp-novel-assistant": {
    "command": "node",
    "args": ["D:\\Codes\\MCPRepo\\mcp-tools\\mcp-novel-assistant\\index.js"]
  }
}

使用方法

启动服务器

node index.js

在MCP Inspector中测试

1. 启动MCP Inspector
2. 连接到小说创作助手服务器
3. 测试各种工具和资源

🤖 大模型使用教程

核心概念

本工具的核心价值在于生成专业级提示词，帮助您与大模型进行高效的小说创作对话。工具本身不直接创作内容，而是为您提供结构化的、专业的提示词模板。

实际使用方式

第一步：直接与大模型对话

正确的使用方式是在大模型对话中直接调用工具，而不是先获取提示词再复制。例如：

目标目录：D:\Codes\NovelAssisant\Novels\幻想红楼梦

以下是需求：
1、本小说从原著的宝玉入住大观园开始
2、一改原著的悲剧结尾，这次我要大团圆结局
3、分100章节，共10卷，每卷和每章节标题都是7个字
4、完全模仿原著的叙事风格
5、依旧是讲述日常事情，而不是神仙鬼怪的事情
6、故事要跌宕起伏，充满儿女情长，让人看了荡气回肠
7、看了要让人回味无穷

请使用我给你的MCP工具：mcp-novel-assistant

第二步：大模型自动调用工具

当您在大模型对话中提供创作需求时，大模型会自动：

1. 识别需求：分析您的创作需求
2. 调用工具：自动调用 novel_init 工具生成专业提示词
3. 创作内容：根据生成的提示词进行专业创作
4. 保存文件：按照指定路径保存创作内容

工具调用方式

小说初始化工具 (novel_init)

参数格式：

{
  "requirements": "您的创作需求描述",
  "novelPath": "小说保存路径"
}

示例调用：

{
  "requirements": "创作一部现代都市小说《代码人生》，主角林晨是一名资深程序员，故事围绕他在互联网大厂的职场竞争、技术挑战和感情纠葛展开。风格偏向现实主义，注重人物内心描写和职场细节。分卷和章节标题都要求7个字。",
  "novelPath": "D:\\Codes\\NovelAssisant\\Novels\\代码人生\\"
}

小说续写工具 (novel_continue)

参数格式：

{
  "requirements": "续写需求描述",
  "novelPath": "小说文件路径"
}

示例调用：

{
  "requirements": "续写第15章，重点描写主角在重要会议上的表现，章节标题7个字，字数4000-5000字",
  "novelPath": "D:\\Codes\\NovelAssisant\\Novels\\代码人生\\"
}

创作流程示例

完整创作流程

1. 初始化小说架构

目标目录：D:\Codes\NovelAssisant\Novels\幻想红楼梦

以下是需求：
1、本小说从原著的宝玉入住大观园开始
2、一改原著的悲剧结尾，这次我要大团圆结局
3、分100章节，共10卷，每卷和每章节标题都是7个字
4、完全模仿原著的叙事风格
5、依旧是讲述日常事情，而不是神仙鬼怪的事情
6、故事要跌宕起伏，充满儿女情长，让人看了荡气回肠
7、看了要让人回味无穷

请使用我给你的MCP工具：mcp-novel-assistant

2. 续写具体章节

请续写第1章，重点描写宝玉第一天入住大观园的场景，字数4000-5000字

3. 继续创作

请续写第2章，描写宝玉与黛玉的初次相遇

使用技巧

1. 需求描述要具体详细

好的描述示例：

目标目录：D:\Codes\NovelAssisant\Novels\我的小说

需求：
1、创作一部现代都市小说，主角是30岁的女医生
2、故事背景设定在北京三甲医院
3、主题围绕医患关系、职场竞争和家庭责任
4、风格要求：现实主义，细腻描写人物内心
5、字数要求：每章4000-6000字，共50章
6、分卷和章节标题都必须是7个字
7、结局要求：温暖治愈，体现人性的美好

2. 路径格式要求

• Windows路径：使用双反斜杠或正斜杠，如 D:\\Codes\\Novel\\ 或 D:/Codes/Novel/
• 相对路径：如 我的小说/ 或 ./novels/
• 路径结尾：建议以斜杠结尾

3. 续写时的上下文提供

在续写时，可以在需求中包含：

• 当前章节的关键情节
• 人物当前状态
• 需要重点发展的方向
• 字数要求
• 风格要求

与大模型配合的最佳实践

1. 一次性提供完整需求

• 将目标目录、创作需求、具体要求一次性提供给大模型
• 避免分段发送，保持需求的完整性

2. 明确创作目标

• 在需求中明确指定小说类型、风格、主题
• 提供具体的字数要求和章节规划
• 说明期望的结局类型

3. 迭代优化

• 根据创作结果调整需求描述
• 在续写时提供更具体的指导
• 保持人物和情节的连贯性

常见问题解决

Q: 大模型没有调用工具怎么办？

A: 确保在需求中明确提到"请使用MCP工具"或"请使用mcp-novel-assistant"。

Q: 创作内容不符合要求怎么办？

A: 在需求中更具体地描述要求，包括风格、字数、重点内容等。

Q: 如何控制创作质量？

A: 在需求中使用"高质量"、"精品"、"文学性"等关键词。

Q: 续写时如何保持连贯性？

A: 在续写需求中明确提及前文的关键情节和人物状态。

高级使用技巧

1. 需求模板化

可以准备不同类型小说的需求模板，快速开始创作：

都市小说模板：

目标目录：[您的路径]
需求：
1、创作一部现代都市小说
2、主角：[职业] + [年龄] + [性格特点]
3、背景：[城市] + [行业/环境]
4、主题：[核心冲突/主题]
5、风格：[现实主义/浪漫主义等]
6、字数：[每章字数] + [总章数]
7、结局：[悲剧/喜剧/开放式]

2. 分阶段创作

• 第一阶段：使用初始化工具创建完整架构
• 第二阶段：逐章节续写，每章提供具体需求
• 第三阶段：根据反馈调整和优化

3. 风格定制

在需求中指定：

• 语言风格（华丽、简洁、幽默等）
• 叙事视角（第一人称、第三人称等）
• 节奏控制（快节奏、慢节奏等）
• 情感基调（温暖、冷酷、悬疑等）

创作指南

提示词工程原理

本工具基于提示词工程的最佳实践，通过精心设计的模板和动态参数替换，生成专业级的小说创作提示词。

提示词结构分析

1. 角色定位层

你是一位集文学大师、故事设计师和读者心理学专家于一身的AI小说创作导师

• 明确大模型的"身份"和专业领域
• 建立创作权威性和专业性

2. 使命目标层

**核心使命**：基于上述用户需求，构建一个既具备商业可读性又充满文学深度的完整小说生态系统

• 明确创作目标和价值导向
• 平衡商业性和文学性

3. 创作哲学层

## 创作哲学原则
- **原创性**：避免任何形式的抄袭，在借鉴中创新
- **深度思考**：每个设定都要有深层的哲学内涵
- **情感真实**：角色的情感必须来源于真实的人性体验

• 提供创作指导原则
• 确保内容质量和深度

4. 输出标准层

## 输出标准
- 章节正文：4000-8000字的精品内容
- 创作手记：技法运用、情感设计、质量自评
- 章节总结：200-300字精炼总结

• 明确具体的输出要求
• 确保内容完整性和质量

小说初始化流程

1. 使用 novel_init 工具创建小说基础架构
2. 设定小说类型、主题和核心概念
3. 生成人物设定和世界观
4. 创建故事大纲和章节规划

小说续写流程

1. 使用 novel_continue 工具进行章节续写
2. 提供当前章节内容和写作要求
3. 选择续写风格和重点方向
4. 获得高质量的续写内容

🎯 使用示例

完整创作流程示例

步骤1：创建小说架构

在大模型对话中直接提供需求：

目标目录：D:\Codes\NovelAssisant\Novels\代码人生

需求：
1、创作一部现代都市小说《代码人生》，主角林晨是一名资深程序员
2、故事背景设定在互联网大厂，围绕职场竞争、技术挑战和感情纠葛展开
3、风格偏向现实主义，注重人物内心描写和职场细节
4、字数要求：每章4000-6000字，共50章，分5卷
5、分卷和章节标题都必须是7个字
6、结局要求：温暖治愈，体现职场成长和人性美好
7、重点描写：技术细节、职场政治、人物成长

请使用我给你的MCP工具：mcp-novel-assistant

大模型会自动调用 novel_init 工具，生成专业提示词并开始创作。

步骤2：续写具体章节

继续在大模型对话中提供续写需求：

请续写第1章，重点描写林晨第一天到新公司报到，遇到技术挑战和同事竞争的场景，字数4000-5000字

大模型会自动调用 novel_continue 工具，生成续写提示词并创作章节内容。

步骤3：继续创作

继续提供续写需求：

请续写第2章，描写林晨与女主角的初次相遇，以及他们在项目中的合作

不同小说类型的创作示例

玄幻小说创作

目标目录：D:\Codes\NovelAssisant\Novels\星辰之主

需求：
1、创作一部玄幻小说《星辰之主》，主角林星辰是一名修仙者
2、背景设定：一个充满灵气的修仙世界，有各种宗门和势力
3、主角特点：天赋异禀但性格坚韧，从底层开始修炼
4、故事主线：修仙成长、宗门争斗、寻找身世之谜
5、风格要求：传统玄幻风格，注重修炼体系和世界观构建
6、字数要求：每章5000-7000字，共100章，分10卷
7、分卷和章节标题都必须是7个字
8、结局要求：主角成为星辰之主，但保持初心

请使用我给你的MCP工具：mcp-novel-assistant

科幻小说创作

目标目录：D:\Codes\NovelAssisant\Novels\火星工程师

需求：
1、创作一部硬科幻小说《火星工程师》，主角陈航是一名火星殖民地工程师
2、背景设定：2150年的火星殖民地，人类正在改造火星环境
3、主角特点：技术专家，负责火星环境改造项目
4、故事主线：技术挑战、政治阴谋、人类未来
5、风格要求：硬科幻风格，注重科学细节和逻辑性
6、字数要求：每章4000-6000字，共80章，分8卷
7、分卷和章节标题都必须是7个字
8、结局要求：人类成功改造火星，但面临新的挑战

请使用我给你的MCP工具：mcp-novel-assistant

历史小说创作

目标目录：D:\Codes\NovelAssisant\Novels\大明工匠

需求：
1、创作一部历史小说《大明工匠》，主角李铁是一名明朝工匠
2、背景设定：明朝中期，手工业发达，工匠地位特殊
3、主角特点：技艺精湛，性格倔强，追求工艺完美
4、故事主线：工艺传承、家族兴衰、时代变迁
5、风格要求：历史正剧风格，注重历史细节和人物刻画
6、字数要求：每章4500-6500字，共60章，分6卷
7、分卷和章节标题都必须是7个字
8、结局要求：工艺传承下去，但时代已经改变

请使用我给你的MCP工具：mcp-novel-assistant

续写技巧示例

高质量续写需求

请续写第15章，重点描写：
1、林晨在重要技术会议上的表现
2、他与竞争对手的激烈辩论
3、女主角对他的暗中支持
4、字数要求：5000-6000字
5、风格要求：紧张刺激，突出职场竞争氛围

情感描写续写

请续写第25章，重点描写：
1、林晨与女主角的第一次约会
2、两人在咖啡厅的深入交谈
3、林晨内心的情感波动和成长
4、字数要求：4000-5000字
5、风格要求：温馨浪漫，细腻描写人物内心

情节推进续写

请续写第35章，重点描写：
1、公司重大项目的关键时刻
2、林晨面临的重要抉择
3、团队合作与个人英雄主义的冲突
4、字数要求：4500-5500字
5、风格要求：紧张激烈，突出人物成长

模块化设计优势

1. 可维护性: 每个功能独立，修改不影响其他模块
2. 可扩展性: 新增功能只需添加新模块，无需修改现有代码
3. 可测试性: 每个模块可以独立测试
4. 代码复用: 工具方法可以在多个模块间共享
5. 团队协作: 不同开发者可以并行开发不同模块

开发指南

添加新工具

1. 在 tools/ 目录下创建新文件
2. 定义工具配置和处理函数
3. 在 registrar.js 中注册新工具

添加新资源

1. 在 resources/ 目录下创建新文件
2. 定义资源配置和处理函数
3. 在 registrar.js 中注册新资源

添加新提示词

1. 在 prompts/ 目录下创建新文件
2. 定义提示词配置和处理函数
3. 在 registrar.js 中注册新提示词

📚 核心价值与优势

为什么选择这个工具？

1. 简化使用流程

• 无需手动调用：不需要手动调用工具或复制提示词
• 自然对话：直接在大模型对话中提供需求即可
• 自动处理：大模型自动识别需求并调用相应工具
• 无缝体验：从需求到创作，流程完全自动化

2. 专业级创作指导

• 结构化设计：基于提示词工程最佳实践
• 动态参数化：根据用户需求自动调整提示词内容
• 质量保证：内置质量标准和创作指导
• 多类型支持：支持玄幻、都市、科幻、历史等多种小说类型

3. 提升创作效率

• 减少试错：避免反复调整提示词
• 标准化流程：建立可复用的创作流程
• 质量一致性：确保每次创作都达到专业水准
• 快速迭代：支持快速续写和修改

4. 降低使用门槛

• 无需专业知识：不需要深入了解提示词工程
• 即用即得：输入简单需求即可获得专业创作
• 中文友好：完全中文界面和指导
• 直观操作：像正常对话一样使用

与传统方法的对比

方面	传统方法	使用本工具
使用方式	需要手动调用工具或复制提示词	直接在大模型对话中提供需求
提示词质量	依赖个人经验，质量不稳定	专业模板，质量有保障
创作效率	需要反复调试提示词	一次对话，立即开始创作
学习成本	需要学习提示词工程	无需专业知识，即学即用
创作质量	因人而异，难以保证	标准化流程，质量稳定
用户体验	复杂的技术操作	自然的对话体验

适用场景

• 新手作者：快速上手AI辅助创作，无需学习复杂技术
• 专业作家：提升创作效率和质量，专注于内容创作
• 内容创作者：批量生产高质量内容，标准化创作流程
• 教育机构：教学AI创作技巧，提供专业创作指导
• 研究机构：研究AI创作模式，分析创作质量
• 个人用户：轻松创作个人小说，享受创作乐趣

实际使用优势

1. 对话式创作

• 自然交互：像与人类作家对话一样自然
• 即时反馈：立即获得创作结果和反馈
• 连续创作：支持连续对话，保持创作连贯性
• 灵活调整：随时调整创作方向和风格

2. 专业指导

• 创作哲学：内置专业的创作理念和标准
• 技术指导：提供详细的写作技巧和技法
• 质量保证：确保每个创作环节都达到专业水准
• 风格定制：支持个性化的创作风格定制

3. 完整生态

• 架构设计：从世界观到人物设定的完整架构
• 章节规划：详细的章节结构和内容规划
• 续写支持：高质量的章节续写和情节发展
• 文件管理：自动化的文件组织和保存

🔧 特性

• ✅ 对话式创作体验
• ✅ 自动工具调用
• ✅ 专业的小说创作指导
• ✅ 多种小说类型支持
• ✅ 高质量章节续写
• ✅ 个性化写作风格
• ✅ 完整的小说架构体系
• ✅ 友好的中文界面
• ✅ 完善的错误处理
• ✅ 模块化设计架构
• ✅ 专业级提示词生成
• ✅ 标准化创作流程
• ✅ 自动化文件管理
• ✅ 连续创作支持
• ✅ 灵活的风格定制

依赖项

• @modelcontextprotocol/sdk: MCP官方SDK
• zod: 数据验证库

许可证

MIT License