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 分