Bloom Study Guides

Bloom — 将 AI 对话转化为配有插图的学习指南（MCP 服务 + 插件）

英文 | 简体中文

用 AI 助手完成某个主题的学习后，将对话转化为 Bloom 上配有插图、按章节编排的学习指南；也可以搜索 Bloom 上已有的学习指南。

该插件只是一个连接器：学习指南由 Bloom 的服务器生成。插件不包含提示词，也不需要 API 密钥。

安装：一条命令

macOS / Linux — 粘贴到终端：

curl -fsSL https://bloombook.cn/install.sh | sh

Windows — 粘贴到 PowerShell：

irm https://bloombook.cn/install.ps1 | iex

它会查找你电脑上的 AI 客户端（Claude Code、Codex / ChatGPT 桌面版、Gemini CLI、Cursor、WorkBuddy、Claude Desktop），将每个客户端连接到 Bloom，并告诉你接下来要做的唯一一件事——通常只需重启应用。它会保留你现有的设置，并且可以安全地重复运行。

然后照常提出学习问题——无需 @ 该插件。

不想打开终端？把这段内容发给你的 AI 助手，它会为你运行安装程序：

Please install the Bloom learning plugin for me: run `curl -fsSL https://bloombook.cn/install.sh | sh` in a terminal, then tell me what its output says is left to do.

功能

• **查找资料：**询问“Bloom 上有关于扩散模型的指南吗？”，助手就会搜索 Bloom 并返回链接。
• **创建学习指南：**学完某个主题后，说“把这些整理成学习资料”。助手会整理这段对话——你问了什么、在哪里遇到困难、已经理解了什么——并提供一个链接。打开链接、登录 Bloom 并确认；大约 20–40 分钟后，指南就会准备就绪，你也会收到通知。指南会重点讲解你遇到困难的部分。

手动安装

上面的命令涵盖了以下所有客户端。只有在想要手动设置某个客户端时，才使用下面的步骤。

Claude Code

/plugin marketplace add HoloSoul-Team/bloom-study-guide-mcp
/plugin install bloom@bloom

Codex

codex plugin marketplace add HoloSoul-Team/bloom-study-guide-mcp
codex plugin add bloom@bloom

或者只添加服务到 ~/.codex/config.toml：

[mcp_servers.bloom]
url = "https://bloombook.cn/api/mcp"

ChatGPT 桌面版

使用上面的 Codex 命令添加市场后，重启 ChatGPT 桌面应用，打开插件目录，选择 Bloom 市场并安装插件。

Gemini CLI

gemini extensions install https://github.com/HoloSoul-Team/bloom-study-guide-mcp

Cursor

添加到 Cursor，或添加到 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "bloom": { "url": "https://bloombook.cn/api/mcp" }
  }
}

WorkBuddy

1. 在左侧边栏打开 连接器 → 自定义连接器（右上角）→ 添加 MCP，然后添加：

   {
     "mcpServers": {
       "bloom": { "type": "http", "url": "https://bloombook.cn/api/mcp" }
     }
   }
   

   这是文件 ~/.workbuddy/mcp.json。点击 bloom 行上的 信任。

2. 将文件夹 plugins/bloom/skills/bloom-study 复制到 ~/.workbuddy/skills/，然后重启 WorkBuddy。

Claude Desktop

Claude Desktop 的自定义连接器需要登录，因此请改用本地桥接进行连接（需要 Node.js）。将以下内容添加到 claude_desktop_config.json（设置 → 开发者 → 编辑配置），然后重启：

{
  "mcpServers": {
    "bloom": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://bloombook.cn/api/mcp"]
    }
  }
}

同一条 npx -y mcp-remote https://bloombook.cn/api/mcp 命令也适用于任何仅支持本地（基于命令）的 MCP 服务的客户端。

其他 MCP 客户端

MCP 端点：https://bloombook.cn/api/mcp（Streamable HTTP，无需身份验证）。工具：search_bloom、create_learning_material。

故障排除

• **WorkBuddy：已安装，但看不到工具：**重启 WorkBuddy，然后打开连接器 → 自定义连接器，点击 bloom 行上的 信任。WorkBuddy 只会在启动时读取配置，并且在你信任新服务之前不会连接它。
• **看不到工具 / 代理环境下出现“error sending request”：**某些代理工具会对不同应用采用不同的路由方式，因此即使浏览器可以正常访问，你的 AI 客户端也可能无法向 bloombook.cn 发送请求。请在代理规则中将 bloombook.cn 设置为直连，或在启动客户端前将其添加到 NO_PROXY（例如 NO_PROXY=localhost,127.0.0.1,bloombook.cn）。
• **链接已过期：**链接有效期为 7 天。请让助手重新创建一个。

隐私

创建学习指南时，助手撰写的对话摘要会存储在 Bloom 的服务器上，用于生成该指南。链接将在 7 天后失效。不要让助手在摘要中写入姓名、联系方式、秘密或其他敏感信息。