Bloom Study Guides MCP server

Bloom — turn AI chats into illustrated study guides (MCP server + plugin)

English | 简体中文

Finish learning something with your AI assistant, then turn the conversation into an illustrated, chapter-by-chapter study guide on Bloom — or search the study guides already on Bloom.

The plugin is only a connector: guides are generated on Bloom's servers. It bundles no prompts and needs no API key.

Install: one command

macOS / Linux — paste into Terminal:

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

Windows — paste into PowerShell:

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

It finds the AI clients on your computer (Claude Code, Codex / ChatGPT desktop, Gemini CLI, Cursor, WorkBuddy, Claude Desktop), connects each one to Bloom, and tells you the one thing left to do — usually just restarting the app. Your existing settings are kept, and it is safe to run again.

Then ask learning questions as usual — no need to @ the plugin.

Prefer not to open a terminal? Send this to your AI assistant and it will run the install for you:

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.

What it does

• Find material: ask "Is there a guide on diffusion models on Bloom?" and your assistant searches Bloom and returns links.
• Create a study guide: after working through a topic, say "make this into study material". Your assistant writes up the conversation — what you asked, where you got stuck, what you already understand — and gives you a link. Open it, sign in to Bloom and confirm; the guide is ready in about 20–40 minutes and you get notified. It focuses on the points you were stuck on.

Manual install

The command above covers all of these. Use the steps below only if you want to set up one client by hand.

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

Or add the server only, in ~/.codex/config.toml:

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

ChatGPT desktop

After adding the marketplace with the Codex command above, restart the ChatGPT desktop app, open the Plugins Directory, pick the Bloom marketplace and install the plugin.

Gemini CLI

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

Cursor

Add to Cursor, or add to ~/.cursor/mcp.json (or .cursor/mcp.json in your project):

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

WorkBuddy

1. Open Connectors in the left sidebar → Custom connector (top right) → Add MCP, and add:

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

This is the file ~/.workbuddy/mcp.json. Click Trust on the bloom row.

1. Copy the folder plugins/bloom/skills/bloom-study into ~/.workbuddy/skills/ and restart WorkBuddy.

Claude Desktop

Claude Desktop's custom connectors require sign-in, so connect through a local bridge instead (needs Node.js). Add to claudedesktopconfig.json (Settings → Developer → Edit Config) and restart:

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

The same npx -y mcp-remote https://bloombook.cn/api/mcp command works for any client that only supports local (command-based) MCP servers.

Other MCP clients

Shortened. The full README is on GitHub.