Htmlbook

io.github.Streamize-llc由 GitHub 帳號 Streamize-llc 發布v1.0.0更新於 Oct 24, 2026

Publish AI-generated HTML & Markdown to a hosted, shareable URL via MCP.

已驗證Streamable HTTP可網頁執行效率與工作流檔案與儲存

概覽

AI 產生的概覽

託管型 MCP 伺服器,可將 AI 產生的 HTML 或 Markdown 文件發布為可分享、具版本的連結,支援公開、密碼或私有存取。

可以做什麼
將 HTML、Markdown 或多檔案包發布為託管且具版本的文件,產生分享連結並提供閱讀主題(紙張、棕褐、深色)。瀏覽、取得並全文搜尋已存放的文件庫,可依專案篩選。整理文件:設定標題、標籤和路徑,在專案間移動、重新命名。控制存取權限:將文件設為公開、密碼保護或私有。取得指向特定章節的深層連結,還原歷史版本,並將文件移至垃圾桶。在手動撰寫 HTML 前取得撰寫規範。
適用情境
當代理產生的 HTML 報告、儀表板、規格文件或筆記需要離開本機、在手機上開啟或以連結形式傳給他人時使用。也適合維護一個可搜尋、具版本的產生文件庫。
執行需求
透過 Streamable HTTP 連線的遠端 MCP 端點。需要身分驗證:OAuth(瀏覽器登入,如 claude.ai 或 Claude Desktop),或在 Authorization 標頭中以 Bearer 權杖傳送的 API 金鑰,金鑰需在服務設定中取得。需要連線至託管服務的網路存取。
安裝前請注意
文件會上傳至第三方託管服務,請勿發布機密內容。文件預設為私有;設為公開或密碼保護後會對他人開放,變更密碼會撤銷先前的存取。工具可重新命名、移動、還原和刪除文件,請留意寫入操作。API 金鑰屬於憑證,不應放入共用設定。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Htmlbook,將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.Streamize-llc%2Fhtmlbook/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "htmlbook": {
      "type": "http",
      "url": "https://htmlbook.io/api/mcp"
    }
  }
}

README

htmlbook

Publish AI-generated HTML and Markdown to a hosted, shareable URL. htmlbook is an MCP server and REST API that takes a document your coding agent just generated — an HTML report, a data dashboard, a spec, meeting notes, an interactive page — and turns it into a clean link you can open on your phone or send to someone, instead of leaving it as a local .html file buried in a project folder.

Push from Claude Code, Cursor, Codex, or claude.ai. htmlbook stores the document, re-themes it for comfortable reading on any device (paper / sepia / dark), keeps every edit as a version, and gives each document one share link with three modes — public (anyone, no login), password-protected (anyone with the password, no login), or a private secret link only you and your workspace can open.

Share the output as a link, not a file. When an agent makes HTML, the awkward part is everything after: getting it off your laptop, onto your phone, in front of someone else. htmlbook is the shelf that part lives on.

  • 🌐 Website: https://htmlbook.io
  • 🔌 MCP endpoint: https://htmlbook.io/api/mcp
  • 📡 REST publish: POST https://htmlbook.io/api/docs
  • 💬 Community: Discord

Quickstart

1. Connect your agent

Get an API key at https://htmlbook.io → Settings, then add the MCP server.

Claude Code (browser login, no key needed):

bash
claude mcp add --transport http htmlbook https://htmlbook.io/api/mcp# then run `claude` and approve the htmlbook login

Claude Code (with an API key):

bash
claude mcp add --transport http htmlbook https://htmlbook.io/api/mcp \  --header "Authorization: Bearer $HTMLBOOK_API_KEY"

Cursor — ~/.cursor/mcp.json:

json
{  "mcpServers": {    "htmlbook": {      "url": "https://htmlbook.io/api/mcp",      "headers": { "Authorization": "Bearer hb_live_REPLACE_WITH_YOUR_KEY" }    }  }}

Codex CLI — ~/.codex/config.toml:

toml
[mcp_servers.htmlbook]url = "https://htmlbook.io/api/mcp"bearer_token_env_var = "HTMLBOOK_API_KEY"

claude.ai / Claude Desktop — add a custom connector with URL https://htmlbook.io/api/mcp (OAuth — no key to paste).

See docs/getting-started.md for every client.

2. Publish a document

Just ask your agent. With the MCP server connected, it calls the publish tool:

text
You: Write up the Q3 numbers as a dashboard and put it on htmlbook.
Agent: htmlbook → publish       ✓ shelved (hbdoc) · acme/q3-dashboard · v1 · read: https://htmlbook.io/app/p/acme/q3-dashboard

Prose (a report, a plan, notes) is easiest as Markdown — htmlbook keeps the .md as the source of truth and renders a themed reader view from it:

json
{  "tool": "publish",  "project": "acme",  "markdown": "# Q3 Review\n\nRevenue is up 8% QoQ...\n\n## Highlights\n- ..."}

3. Share it

Documents are private by default. Make one public to get a link anyone can open:

text
Agent: htmlbook → set_access  (visibility: public)       ✓ acme/q3-dashboard is now public · https://htmlbook.io/d/a1b2c3

That's the whole loop: generate → publish → share.


What you can publish

FormatWhenWhat htmlbook does
MarkdownProse: reports, plans, notes, specsKeeps the .md as the source of truth, renders a themed reader view (TOC, tables, callouts, task lists), stays downloadable + editable as Markdown
hb-doc HTMLRich docs: dashboards, KPIs, inline SVG chartsA <article class="hb-doc"> fragment styled only with hb-* classes + --hb-* tokens — the reader supplies the stylesheet and re-themes it (paper / sepia / dark, width, font size)
BundleA self-contained page with its own CSS/JSStored verbatim and rendered in a sandboxed iframe — your scripts run, your styling is preserved. Can be multi-file (index.html + sub-pages + assets, ≤10MB) for a small static site with working relative links

The format is auto-detected at publish. You never have to declare it — push Markdown, push an hb-doc fragment, or push a full standalone HTML page and htmlbook routes it.

See docs/publishing.md and docs/hb-doc-contract.md.


Why htmlbook

  • Off your laptop. An agent's HTML output is stuck on the machine that made it. htmlbook gets it onto your phone and into a shareable link.
  • Readable everywhere. Because an hb-doc carries no CSS of its own, the reader themes it — the same document looks right on a phone in the dark and a desktop in daylight.
  • Versioned. Every publish and every in-reader edit is a new immutable version. The History panel shows who changed what; any version restores.
  • Markdown stays Markdown. A Markdown push is not lossily converted to HTML — the original .md is the source of truth and round-trips on download.
  • Private by default. Nothing is public until you flip it. Three share modes: public (anyone), password-protected (anyone with the password, no login — changing it revokes prior access), or a secret link session-gated to your workspace.
  • Token-cheap. Push a large document as a file over the REST API so its bytes never pass back through your agent's context. See docs/rest-api.md.

The MCP tools

The htmlbook MCP server exposes 10 tools. Full reference: docs/mcp-tools.md.

ToolPurpose
publishShelve a document (HTML or Markdown) to a hosted URL; new version if it exists
guideGet the authoring contract (hb-doc classes, tokens, components) before composing HTML by hand
listBrowse your library, optionally filtered by project
getFetch a document's metadata + current body (for markdown, the .md source)
searchFull-text search across everything you've shelved (recall before re-deriving)
organizeSet title / tags / path, move between projects, rename
set_accessMake a document public, password-protected, or private
citeGet a shareable deep-link to a specific section (heading) of a document
restoreRoll a document back to an earlier version
deleteMove a document to the trash

Supported clients

ClientAuth
Claude CodeAPI key over MCP, or browser login; also REST
CursorAPI key over MCP
Codex CLIAPI key over MCP; also REST
claude.aiOAuth (custom connector)
Claude DesktopOAuth (custom connector)
Any MCP clientStreamable HTTP + Bearer key or OAuth 2.1

Documentation


Made by Streamize. Documentation is MIT-licensed; htmlbook itself is a hosted service at htmlbook.io.

來源:README.md,提交 70d2a07

工具

0
該伺服器需要登入,因此 SourceWeft 無法在沒有帳號的情況下讀取其工具,也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 60%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分