内容
写作 MCP
**将你的创意通过 AI 转化为已出版的书籍**
每个人都有一个故事要讲，有一个世界观要分享，或者有值得出版的专业知识。拥有想法和握有完成的稿件之间的差距一直很大 —— 需要数月的孤独自律、结构性的摸索，以及对失去创作思路的不断恐惧。书籍写作 MCP 缩小了这一差距。
这是一个 [模型上下文协议](https://modelcontextprotocol.io) 服务器，为 Claude（或任何与 MCP 兼容的 AI）提供了一整书籍写作工具。你可以谈论你的书籍，AI 会写作、组织、跟踪和导出 —— 同时你仍然保持创作控制。
## 你能获得什么
- **从一句话开始写书**。描述你的创意，AI 初始化项目，创建大纲，并开始草拟章节 **在 10 万字中保持一致**。故事圣经跟踪每个角色、场景和情节线索。连续性检查在重写之前捕获矛盾。
- **用你的声音写作**。风格指南捕捉你的语调、视角、时态、影响和模式，以避免 —— 因此每一章听起来都像 *你*，而不是普通的 AI。
- **看到你的书籍成形**。内置的 HTML 预览以漂亮的书籍排版渲染你的手稿 —— Playfair Display 标题、首字母大写、 justified 文本、装饰分隔符。预览服务器每 10 秒自动刷新；在编辑章节后运行 `bookdown` 以更新预览。
- **导出到真实的格式**。一个命令将你的手稿编译为干净的 Markdown 或格式化的 `.docx`，带有封面、目录、页码和可配置的字体/间距。
- **设计你的封面**。使用情绪、色彩调色板、排版和 AI 图像提示生成 KDP 兼容的封面规格，适用于 DALL-E、Midjourney 或 Stable Diffusion。
- **建立你的作者简介**。从 LinkedIn 提取或手动编写 —— 生成用于封底和营销的精致生物。
## 快速入门
### 安装
```bash
git clone https://github.com/arupmaity1/book-writer-mcp.git
cd book-writer-mcp
npm install
npm run build
```
### 添加到 Claude Desktop
将以下内容添加到你的 Claude Desktop MCP 配置文件（`~/Library/Application Support/Claude_desktop_config.json` 在 macOS 上）：
```json
{
"mcpServers": {
"book-writer": {
"command": "node",
"args": ["/path/to/book-writer-mcp/dist/index.js"],
"env": {
"BOOK_PROJECT_DIR": "/path/to/your/book/f }
}
}
}
```
### 添加到 Claude 代码
在你的项目的 `.mcp.json` 中：
```json
{
"mcpServers": {
"book-writer": {
"command": "node",
"args": ["//book-writer-mcp/dist/index.js"],
"env": {
"BOOK_PROJECT_DIR": "."
}
}
}
}
```
### 开始写作
打开 Claude 说：
> “初始化一个名为‘放手的艺术’的新书目 —— 这是一本关于离开企业生活以建立有意义的事物的回忆录。目标是 5 万字。”
就是这样。AI 创建了项目结构，你就可以开始写作了。
## 工具参考
### 手稿（核心工作流程）
| 工具 | 功能 |
|------|-------------|
| `book_init` | 初始化一个新书目项目 |
| `book_chapter_create` | 创建一个新章节 |
| `book_chapter_read` | 读取章节的内容和元数据 |
| `book_chapter_update` | 将更新的内容写入章节 |
| `book_chapter_list` | 列出所有章节及其状态和字数 |
| `book_chapter_reorder` | 更改章节顺序 |
book_stats` | 全手稿统计数据 |
### 故事圣经（世界构建和连续性）
| 工具 | 功能 |
|------|-------------|
| `book_character_add` | 将角色添加到故事圣经中 |
| `book_character_update` | 更新角色的详细信息 |
| `book_character_get` | 检索角色的完整资料 |
| `book_character_list` | 列出所有角色 |
| `book_setting_add` | 添加场景（地点、世界、组织） |
| `book_setting_get` | 检索场景的详细信息 |
| `book_setting_list` | 列出所有场景 |
| `book_plot_thread_add` | 跟踪一个开放的情节线索 |
| `book_plot_thread_resolve` | 将情节线索标记为已解决 |
| `book_plot_threads_list` | 按状态列出情节线索 |
| `book_continuity_check` | 将章节与故事圣经进行交叉引用 |
### 大纲
| 工具 | 功能 |
|------|-------------|
| `book_outline_set` | 设置完整的大纲 |
| `book_outline_get` | 检索大纲 |
| `book_outline_update_chapter` | 更新章节的摘要或场景 |
### 风格指南
| 工具 | 功能 |
|------|-------------|
| `book_style_set` | 设置完整的风格指南（声音、视角、时态、语调） |
| `book_style_get` | 检索风格指南 |
| `book_style_check` | 检查段落与风格指南的一致性 |
| `book_style_add_influence` | 添加作者影响力 |
| `book_style_list_influences` | 列出作者影响力 |
| `book_style_remove_influence` | 删除作者影响力 |
### 导出
| 工具 | 功能 |
|------|-------------|
| `book_export_markdown` | 将所有章节编译为单个 Markdown 文件 |
| `book_export_docx` | 导出格式化的 `.docx`，包含封面、目录和页码 |
### 预览
| 工具 | 功能 |
|------|-------------|
| `book_preview` | 生成具有书籍排版的 预览 |
| `book_preview_server` | 创建具有 10 秒自动刷新的实时预览服务器 |
### 封面设计
| 工具 | 功能 |
|------|-------------|
| `book_cover_kdp_specs` | 获取 KDP 封面规格（电子书、平装本、精装本） |
| `book_cover_create_spec` | 创建封面设计规格 |
| `book_cover_get_spec` | 检索封面规格 |
| `book_cover_generate_prompt` | 从封面规格生成 AI `book_cover_checklist` | KDP 发布准备检查清单 |
### 作者简介
| 工具 | 功能 |
-------------|
| `book_author_from_linkedin` | 从 LinkedIn 构建作者简介 |
| `book_author_update_profile` | 手动更新简介详细信息 |
| `book_author_regenerate_intro` | 从简介数据重新生成生物 |
| `book_author_update_intro` | 直接编辑生成的生物 |
| `book_author_get_profile` | 检索完整的作者简介 |
## 项目结构
当你初始化一本书时，MCP 在你的项目目录中创建此结构：
```bash
your-book/
.book-mcp/
registry.json # 书籍元数据、章节列表、字数
story-bible.json # 角色、场景线索、时间线
style-guide.json # 声音、语调、视角、影响力
outline.json # 具有情节和场景的层次大纲
cover-spec.json 封面设计规格 author-profile.json # 作者简介和简介数据
chapters/
ch-001-your-first-chapter.md
ch-002-the-next-one.md
...
manuscript.md # 由 book_export_markdown 创建
manuscript.docx # 由 book_export_docx 创建
preview.html # 由 book_preview 创建
preview/
server # 由 book_preview_server 创建
```
## 预器
内置预览以漂亮的排版渲染你的手稿：
- **Playfair Display** 标题，带有的首字母大- **Source Serif 正文， justified with hyphens
- 段装饰性 bullet 点
- 奶油色纸张背景，带有细微的阴影
- 固定的字数徽章
- 响应式设计，适用于任何设备上的阅读
- 使用预览每 10 秒自动刷新（在编辑章节后重新book_export_markdown` 以更新内容）
运行 `` 获取静态 HTML 文件，或运行 `book_preview_server位于 `http://localhost:3456` 的预览服务器 写作工作流程
### 初次作者
> “我想写一本关于我 20 年医疗经历的书 —— 新护士不告诉你的事情。帮助我构建它。”
AI 将创建你的项目，从你的经历中建立大纲，设置风格指南，并开始逐章草拟。你说话，它写作，你修改。
### 小说作者
> “我正在写 1920 年代孟买为背景的悬疑小说。三个主要角色，多个时间线。帮助我保持一切顺利。”
故事圣经跟踪每个角色、关系和情节线索。连续性检查会标记矛盾。时间线保持你的双重叙事同步。
### 商业/非小说类
> “把我对供应链优化的专业知识转化为一有一些关键笔记和博客文章可以开始。”
AI 将你的知识结构化为章节，保持一致的专业语调，并从你的 LinkedIn 个人资料中生成封面规格和作者简介。
### 自出版到 KDP
> “我的手稿。帮助我为 Kindle Direct Publishing 做准备。”
导出到 `.docx`，具有适当的格式，生成具有精确尺寸的 KDP 兼容封面规格，运行发布检查清单，并预览最终结果。
## 需求
- Node.js 18+
- 与 MCP 兼容的客户端（Claude Desktop，Claude Code 或任何 MCP 客户端）
## 许可证
MIT
