
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 分