bedbook-plugins

Bedbook - 儿童故事 MCP 服务

Bedbook 是一个基于 MCP (Model Context Protocol) 协议的儿童故事服务。它提供故事列表和搜索功能，可以集成到支持 MCP 的 AI 应用中，帮助用户查找和阅读适合不同年龄段的儿童故事。

功能特点

• 故事列表: 列出所有可用故事，展示标题、年龄段、关键词等元信息
• 智能搜索: 支持按年龄段、名称、关键词、分类、内容模糊搜索，返回最佳匹配结果
• 阅读统计: 记录每个故事的阅读次数，帮助了解热门故事
• MCP 协议: 标准化的 MCP 工具接口，可无缝集成到 Claude、Cursor 等 AI 应用
• 灵活部署: 支持 stdio 和 HTTP 两种传输方式

技术栈

• 语言: TypeScript 5.x
• 运行时: Node.js (ES2022)
• MCP 框架: bestmcp SDK
• 参数验证: Zod
• 包管理器: pnpm
• 构建工具: tsup

快速开始

Bedbook 是一个 MCP 服务，你可以通过支持 MCP 的 AI 应用来使用它。以下是常见的配置方式：

在 Claude Desktop 中配置

编辑配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "bedbook": {
      "command": "npx",
      "args": ["-y", "bedbook"]
    }
  }
}

在 Cursor 中配置

在项目根目录创建或编辑 .cursor/mcp.json 文件：

{
  "mcpServers": {
    "bedbook": {
      "command": "npx",
      "args": ["-y", "bedbook"]
    }
  }
}

使用示例

配置完成后，你可以直接与 AI 对话来使用 Bedbook：

• "给我找一个适合 5 岁孩子的关于勇敢的故事"
• "有哪些故事可以讲给孩子听？"
• "帮我找一个叫'小老虎'的故事"

使用技巧

提示: 如果你使用的 AI 工具搭载的是较小的模型，它可能会对故事进行精简总结而非完整讲述。这并非 MCP 服务或故事本身的问题，可以通过提示词来引导模型完整输出故事内容。

如果遇到故事被精简的情况，可以尝试在对话中使用以下引导提示词：

请完整地讲述这个故事，不要进行总结或精简。我希望能听到故事的每一个细节，包括所有对话和情节。请保持故事原有的语言风格和完整长度。

或者更直接的提示：

请逐字逐句地讲这个故事，不要遗漏任何内容。

这样可以确保模型输出完整的故事内容，让孩子能够享受完整的故事体验。

自定义故事目录（可选）

如果你想使用自己的故事文件，可以通过环境变量指定故事目录：

{
  "mcpServers": {
    "bedbook": {
      "command": "npx",
      "args": ["-y", "bedbook"],
      "env": {
        "BEDBOOK_STORIES_DIR": "/path/to/your/stories"
      }
    }
  }
}

Claude Plugin 支持

Bedbook 提供了一个 Claude Plugin，让你可以直接在 Claude Code 中使用 /add-story 命令快速生成儿童故事。

安装 Plugin

添加 Marketplace

首先添加 bedbook-plugins marketplace：

/plugin marketplace add shenjingnan/bedbook

如果你无法访问 github 可以尝试使用 gitee

/plugin marketplace add https://gitee.com/shenjingnan/bedbook.git

安装 Plugin

然后安装 bedbook plugin：

/plugin install bedbook@bedbook-plugins

使用 Plugin

安装完成后，你可以使用 /bedbook:add-story 技能生成故事：

如果安装成功，但是没有发现 /bedbook:add-story 技能，可以尝试重启 Claude Code

/bedbook:add-story 小兔子找太阳
/bedbook:add-story 守株待兔 --age 5-7岁
/bedbook:add-story 一只勇敢的小猫去森林冒险 --keywords 勇敢,冒险,成长

支持的输入类型

• 故事名称: 直接提供故事标题
• 成语: 将成语改编为儿童故事
• 故事大纲: 根据大纲扩展完整故事

可选参数

• --age <年龄段>: 指定目标年龄段（如 3-5岁）
• --keywords <关键词>: 指定关键词（逗号分隔）

命令行使用

你也可以通过命令行直接调用 plugin 生成故事：

claude -p --permission-mode acceptEdits "/bedbook:add-story 闻鸡起舞"

同样支持可选参数：

claude -p --permission-mode acceptEdits "/bedbook:add-story 守株待兔 --age 5-7岁"
claude -p --permission-mode acceptEdits "/bedbook:add-story 一只勇敢的小猫去森林冒险 --keywords 勇敢,冒险,成长"

这种方式适合在脚本中使用或快速生成故事。

插件功能

该 plugin 提供以下功能：

• ✅ 自动生成符合项目规范的故事文件
• ✅ 检查故事标题和内容是否与现有故事重复
• ✅ 根据年龄段调整语言风格和故事长度
• ✅ 自动生成 5-8 个关键词
• ✅ 确保故事具有教育意义和积极结局

安装

环境要求

• Node.js >= 20.0.0
• pnpm >= 10.0.0

安装依赖

pnpm install

使用

开发模式

# stdio 传输模式（默认）
pnpm dev

# HTTP 传输模式
pnpm dev:http

生产模式

# 构建项目
pnpm build

# stdio 传输模式
pnpm start

# HTTP 传输模式
pnpm start:http

开发工具

# 测试
pnpm test              # 运行测试
pnpm test:watch        # 监听模式运行测试
pnpm test:coverage     # 运行测试覆盖率

# 代码质量
pnpm lint              # 代码检查
pnpm lint:fix          # 自动修复代码问题
pnpm format            # 格式化代码
pnpm typecheck         # 类型检查
pnpm spellcheck        # 拼写检查

环境变量

变量名	说明	默认值
MCP_TRANSPORT	传输方式 (stdio/http)	stdio
MCP_PORT	HTTP 模式端口	3000
MCP_HOST	HTTP 模式主机	0.0.0.0
BEDBOOK_STORIES_DIR	自定义故事目录	./stories

MCP 工具

listStories

列出所有故事（不含完整内容）。

参数: 无

返回示例:

{
  "success": true,
  "count": 10,
  "stories": [
    {
      "filename": "小老虎怕下雨.md",
      "title": "小老虎怕下雨",
      "age": "3-7岁",
      "keywords": ["勇敢", "友谊"],
      "author": "未知",
      "category": "儿童故事",
      "language": "zh",
      "readCount": 5
    }
  ]
}

searchStory

根据条件搜索故事，返回最佳匹配（含完整内容）。

参数: