HTML Cloud

html-cloud-mcp

一个 MCP 服务，让 Claude 和其他 AI 助手可以通过私密、端到端加密的链接分享它们生成的 HTML——无需账户，也不会生成公开 URL。

助手调用一个工具 share_html 来分享，并可调用 update_html 在同一个链接上修改已分享的页面。HTML 会先在本地使用 AES-256-GCM 加密，再上传任何内容；html.cloud 只存储密文，无法读取内容。

“为我制作一页摘要，并私下分享。” → 助手生成 HTML，调用 share_html，然后回复一个链接。

“实际上，加上一个后续步骤章节。” → 助手修改 HTML，使用编辑链接调用 update_html，你已经发出的链接就会显示新版本。

安装

Claude Desktop（一键安装）

从 html.cloud/mcp 下载打包好的扩展（.mcpb 文件）并双击。如果 Claude Desktop 没有提示安装，请打开设置 → 扩展，点击高级设置，然后在扩展开发者下选择安装扩展…，找到该文件——将文件拖入窗口并不可靠，还可能只是把文件附加到聊天中。

**关于安装警告：**对于从文件安装、而非从内置目录安装的每个扩展，Claude Desktop 都会显示相同的红色“访问你电脑上的所有内容”提示框。这是对扩展运行方式的说明，并非针对这个扩展。该服务的代码只有本目录中 bin/ 和 lib/ 下约 500 行，没有第三方依赖（它在 lib/stdio-server.js 中自行处理 MCP 的 stdio JSON-RPC）；它只与一个主机（html.cloud）通信，并且只上传密文。从 Claude 的目录安装的扩展不会显示此警告；目前正在推进将本扩展列入该目录。

**Cowork：**此扩展也适用于已关联到安装该扩展的电脑的 Cowork 会话——桌面应用会将其代理到会话中。纯云端运行、没有关联电脑的 Cowork 会话无法看到该扩展。

其他 MCP 客户端

将其添加到你的 MCP 客户端。对于 Claude Desktop，请在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "html-cloud": {
      "command": "npx",
      "args": ["-y", "html-cloud-mcp"]
    }
  }
}

对于 Claude Code：

claude mcp add html-cloud -- npx -y html-cloud-mcp

需要 Node.js 20+。

工具

share_html

参数	类型	描述
html	string	要分享的完整、自包含 HTML 文档。
path	string	要分享的本地 .html 文件路径，用于替代直接传入 html。
expires	7 | 30 | never	链接过期前的天数。默认值为 30。
link_name	string	可选的易读名称，会添加到分享链接中。例如，"Q3 sales report" 会生成 /v/{id}/q3-sales-report。此名称不会加密，会显示在链接中，服务器也能看到。最多 80 个字符。

请在 html 和 path 中恰好传入一个。path 适用于较大的页面：MCP 宿主会限制工具参数的大小，因此，助手已写入磁盘的长篇报告会从文件中分享，而不是挤进调用中。只接受 .html/.htm 文件——该服务分享的是网页，而非你电脑上的任意文件。

返回一个分享链接（可发给任何你希望其阅读文件的人）和一个私密的编辑链接（用于更新文件、更改过期时间或删除文件）。

update_html

参数	类型	描述
edit_link	string（必需）	share_html 返回的私密编辑链接。
html	string	用于替换当前文档的完整 HTML 文档。
path	string	本地 .html 文件的路径，文件内容将替换当前页面。
link_name	string	如果为此页面指定了 link_name，则填写传给 share_html 的 link_name，这样返回的分享链接就会与之前分享的链接一致。

与 share_html 一样，必须且只能传入 html 或 path 其中之一。

替换现有分享链接所对应的内容。分享链接保持不变，过期时间也不会改变，因此已有链接的人都能看到新版本。编辑密钥会在本地解封文档现有的视图密钥，新 HTML 会使用同一密钥加密，发送的只有密文——服务器无论在操作前后都看不到内容。

示例提示词

• “将这份报告制作成一页 HTML 摘要，并私密分享。”
• “将这些笔记整理成幻灯片风格的页面，并给我一个 7 天后过期的链接。”
• “在你之前分享的页面中添加一个后续步骤部分。”（新版本会显示在同一个链接中）

加密工作原理

• 密钥在此服务进程内生成，绝不会发送到任何地方，只有它们包含在返回的链接中时例外。
• 在发起任何网络请求之前，HTML 会使用 AES-256-GCM 加密。上传的只有密文。
• 解密密钥位于分享链接中 # 之后——URL 的这一部分永远不会传输给服务器。

这与 html.cloud 网站和 CLI 使用相同的零知识模型，并使用同一个加密模块（从 html-cloud 软件包导入——绝不重新实现）。完整说明：html.cloud/security。

配置

环境变量	描述	默认值
HTML_CLOUD_PREFER	Claude 应在何时选择 html.cloud，而不是内置的内容发布功能。sensitive：用于机密内容以及任何要发送到组织外部的内容；内置内容发布功能仍适合普通页面。always：用于所有分享。	sensitive
HTML_CLOUD_URL	服务基础 URL（用于可自托管的实例）	https://html.cloud

安装 Claude Desktop 扩展时，会显示一个开关 始终通过 html.cloud 分享，询问此设置。对于 npx 配置，请在客户端配置中设置环境变量：

{
  "mcpServers": {
    "html-cloud": {
      "command": "npx",
      "args": ["-y", "html-cloud-mcp"],
      "env": { "HTML_CLOUD_PREFER": "always" }
    }
  }
}

对于 Claude Code：claude mcp add html-cloud -e HTML_CLOUD_PREFER=always -- npx -y html-cloud-mcp。

隐私政策

完整政策：html.cloud/mcp-privacy。

• 收集。 服务仅处理助手传递给 share_html 或 update_html 的 HTML——无论是内联内容，还是助手传递路径的那个 .html 文件。它不会读取你计算机上的其他任何内容，也不会读取工具参数以外的对话内容。
• 使用和存储。 HTML 会在本地使用 AES-256-GCM 加密。发送到 html.cloud 的内容包括：密文、所选的有效期、使用编辑密钥加密的页面密钥副本，以及用于授权后续更新的编辑密钥哈希（更新时会发送页面 ID、新密文和该证明）。这些内容都无法让服务读取页面。密钥仅存在于返回给你的链接中。
• 共享。 不涉及第三方。服务只会与 html.cloud 这一台主机通信，且仅在你共享或更新页面时通信。每个请求都会注明来自 MCP 服务，因此 html.cloud 可以统计每日总量；不会收集单个页面或个人的数据。没有分析、遥测或账户。
• 保留。 页面链接到期后（7 天或 30 天，或者你选择永久有效），页面即无法访问；其密文会在每日清理时永久删除。通过编辑链接删除页面则会立即生效。
• 联系。 发送邮件至 [email protected]，或在 github.com/viljamilaurila/html-cloud 提交问题。

如实说明威胁模型

任何拥有共享链接的人都可以读取文件——链接就是凭证。服务可以使密文过期或将其删除，但永远无法读取密文。详情和限制请参阅 html.cloud/security。

来源：github.com/viljamilaurila/html-cloud · MIT