Name: Novel Factory MCP
Availability: InStock
Rating: 5.0 (1 reviews)
Author: novel-mcp

接入指南 · 零基础

三步接入 · 最快 5 分钟跑通

方式一：Cherry Studio（推荐，最快）。方式二：任意 MCP 客户端 / 自有网站后端。无需编程基础，不会写代码也能用——配置粘贴即用，剩下的交给 AI 客服（guide_usage）手把手带你写。

🙋 我是非技术作者，真的能用吗？

能。你只需要会用 Cherry Studio（一个免费 AI 客户端，界面像聊天软件）。复制下面这段 JSON → 粘贴 → 保存，novelmcp.top 的 36 个写作工具就挂上去了。之后直接对 AI 说「帮我写一本小说」，它自动调用工具跑完流程。全程不用碰 env、不用申请 key。

复制 JSON 配置

复制下方 novel-mcp 远程 MCP 配置。直接连接网站服务器，零下载零配置，无需 API key，智能体自动用自己的模型。

Cherry Studio 粘贴

打开 Cherry Studio → 设置 → MCP 服务器 → 粘贴 JSON → 保存。

断开 → 重连 · 跑通第一章

保存后断开重连。首跑盯 stdout：出现「novel-mcp（all-in-one）启动」即连接成功。让 AI 客服（guide_usage）带你走全流程。

一键配置

novel-mcp 远程 MCP · 复制即用

一个 MCP 聚合全部 36+ 工具。无需 API key，你的智能体自动用自己的模型。

Cherry Studio JSON（直接复制）{
  "mcpServers": {
    "novel-mcp": {
      "type": "http",
      "url": "https://novelmcp.top/mcp"
    }
  }
}

💡 高级用户可自行配置额外 env（质量门 / 番茄适配 / 幂等等，见技术文档），全部有默认值。

Agent 一键挂载 · 按客户端

不同客户端，最懒的挂载方式

下面按你实际使用的客户端分类。核心只有一条配置：{"type":"http","url":"https://novelmcp.top/mcp"}。把它挂上去， novel-mcp 的 36 个工具就可用。

① Cherry Studio（最常用）—— 直接改配置文件

Cherry Studio 没有 claude 命令，不能执行 claude mcp add。最快方式是直接改它的 mcp.json 配置文件，比打开设置面板还快：

Windows 配置文件路径C:\Users\%USERNAME%\AppData\Roaming\CherryStudio\mcp.json

把下面 JSON 对象合并进该文件（不要删掉你已有的其他服务器）。保存后重启 Cherry Studio 即可。

Cherry Studio 配置片段{
  "mcpServers": {
    "novel-mcp": {
      "type": "http",
      "url": "https://novelmcp.top/mcp",
      "headers": {},
      "isActive": true
    }
  }
}

验证：Cherry Studio 设置 → MCP 服务器 → 看到 novel-mcp 已启用；对话框输入「帮我写小说」能触发工具。

② Claude Code CLI（有 claude 命令的终端）

如果你用的是 Claude Code / 任何支持 claude mcp 子命令的客户端，在终端执行一行即可注册。注意：这不是 Cherry Studio 的命令，Cherry Studio 没有 claude 命令。

一行挂载（项目级）claude mcp add --transport http novel-mcp https://novelmcp.top/mcp

一行挂载（全局）claude mcp add --transport http novel-mcp --scope user https://novelmcp.top/mcp

验证：claude mcp list；移除：claude mcp remove novel-mcp。

③ AutoMCP —— Cursor / VS Code / Claude Desktop 的自动化方案

AutoMCP（lirantal/automcp）能自动识别 Cursor / VS Code / Claude Desktop 的项目级配置，并把 novel-mcp 写进去，不覆盖、不重复已有服务器。对 HTTP 远程服务，它只需要你提供下方这条 URL 条目：

AutoMCP 通用 MCP 条目{
  "mcpServers": {
    "novel-mcp": {
      "type": "http",
      "url": "https://novelmcp.top/mcp"
    }
  }
}

AutoMCP 目前主要针对 Cursor / VS Code / Claude Desktop；Cherry Studio 用户请直接用 ① 的配置文件方式。

④ 任意客户端（Cursor / VS Code）—— Python 一行合并

把下方命令粘到终端，自动合并进 .cursor/mcp.json（VS Code 改成 .vscode/mcp.json），不破坏已有配置：

Python 一行合并写入python - <<'PY'
import json, pathlib
p = pathlib.Path(".cursor/mcp.json")
d = json.loads(p.read_text()) if p.exists() else {}
d.setdefault("mcpServers", {})["novel-mcp"] = {"type": "http", "url": "https://novelmcp.top/mcp"}
p.write_text(json.dumps(d, ensure_ascii=False, indent=2))
print("novel-mcp 已写入", p)
PY

调用范式

从章卡到成品章节

异步流程优先：write_chapters_async → 返回 job_id → 轮询 get_write_status → 完成即落盘。同步接口 3 章以上易触发客户端 60s 超时。

调用示例 · JSON{
  "book_dir": "D:/第四步正文",
  "chapters": [
    {
      "chapter_index": 1,
      "chapter_card": { "核心冲突": "...", "节奏位置": "rising", "爽感预算": 6 },
      "title": "第一章 标题"
    }
  ]
}

异步范式 · 推荐write_chapters_async({ book_dir, chapters: [...100章] })
    → { "job_id": "a1b2c3" }        # 毫秒级返回
    → get_write_status({ job_id: "a1b2c3" })
    → { "status": "completed", "files": [...] }

💡 中断恢复：异步任务状态持久化（FSM_RECOVERY_ENABLED），重启后自动恢复未完成任务；幂等指纹保证不重复落盘。

本地 / 云部署

novel-mcp 单进程启动

novel-mcp 是单进程聚合：一条命令启动，全部 36+ 工具对外服务。

本地启动（stdio 挂载）# 环境自检（确认 mcp==1.28.1）
python launcher.py check

# 启动 novel-mcp（一条命令，含 outline/writer/coach/kd/AI客服）
python mcp-servers/all-in-one-server/src/main.py

云部署（Streamable HTTP）# HTTP 模式：对外暴露 /mcp 端点（供远程客户端调用）
python mcp-servers/all-in-one-server/src/main.py --http  # 或 GATEWAY_MODE=http

# Cherry Studio 远程连接
{
  "mcpServers": {
    "novel-mcp": {
      "type": "http",
      "url": "https://your.domain/mcp"
    }
  }
}

排错 · 零基础友好

接不上？看这 4 条

绝大多数问题 1 分钟解决。仍不行就加开发者微信（见首页定制区块）。

保存后不显示工具

确认 JSON 的 type 是 "http"、url 是 https://novelmcp.top/mcp。保存后断开再重连一次 MCP 服务器。

断开 → 重连

提示超时 / 60s

批量写章用异步接口 write_chapters_async，秒回 job_id；不要一次性让同步接口写 3 章以上。

用异步

要填 API key 吗

不用。Novel Factory MCP 不指定大模型，你的 AI 客户端（Cherry Studio）自动用自己的模型调用工具。配置里没有 key 字段。

BYOK 零密钥

AI 不会自动调用

直接说「帮我新建一本玄幻小说并写前 3 章」，或在 Cherry Studio 工具列表里手动点对应工具。AI 客服 guide_usage 会逐步带。

说人话即可

遇到问题？

看 FAQ，或直接联系开发者（长沙 · 李紫圣）。

常见问题技术文档