
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.
概覽
託管型 MCP 伺服器,可將 AI 產生的 HTML 或 Markdown 文件發布為可分享、具版本的連結,支援公開、密碼或私有存取。
- 可以做什麼
- 將 HTML、Markdown 或多檔案包發布為託管且具版本的文件,產生分享連結並提供閱讀主題(紙張、棕褐、深色)。瀏覽、取得並全文搜尋已存放的文件庫,可依專案篩選。整理文件:設定標題、標籤和路徑,在專案間移動、重新命名。控制存取權限:將文件設為公開、密碼保護或私有。取得指向特定章節的深層連結,還原歷史版本,並將文件移至垃圾桶。在手動撰寫 HTML 前取得撰寫規範。
- 適用情境
- 當代理產生的 HTML 報告、儀表板、規格文件或筆記需要離開本機、在手機上開啟或以連結形式傳給他人時使用。也適合維護一個可搜尋、具版本的產生文件庫。
- 執行需求
- 透過 Streamable HTTP 連線的遠端 MCP 端點。需要身分驗證:OAuth(瀏覽器登入,如 claude.ai 或 Claude Desktop),或在 Authorization 標頭中以 Bearer 權杖傳送的 API 金鑰,金鑰需在服務設定中取得。需要連線至託管服務的網路存取。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Htmlbook,將其新增到工作區。
- 連接 所需的 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
- 為需要使用其工具的對話啟用該服務。
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):
Claude Code (with an API key):
Cursor — ~/.cursor/mcp.json:
Codex CLI — ~/.codex/config.toml:
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:
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:
3. Share it
Documents are private by default. Make one public to get a link anyone can open:
That's the whole loop: generate → publish → share.
What you can publish
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
.mdis 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.
Supported clients
Documentation
- Getting started — connect every client, get a key
- Publishing — the three formats, the
publishtool, examples - Markdown — source of truth, frontmatter, folder sync
- The hb-doc contract — classes, tokens, components
- Sharing & access — public, password, secret links, workspaces
- MCP tools reference — all 10 tools with example calls
- REST API —
POST /api/docs, token-cheap file pushes - examples/ — a report, a dashboard, a folder-sync setup
Made by Streamize. Documentation is MIT-licensed; htmlbook itself is a hosted service at htmlbook.io.
來源:README.md,提交 70d2a07
工具
0版本歷史
1- v1.0.0最新Sep 16, 2026
評分
已滿足適用檢查項的 60%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通必需25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式必需10 分
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分