CloudBase HTML MCP

简体中文 | English

把 Agent 生成的单 HTML，发布到自己的 CloudBase，持续更新同一个分享链接。

面向经常分享报告、演示、原型和小工具的个人与小团队。通过支持本地 STDIO MCP 的 Agent，直接完成发布、检索、更新、下线与恢复；既可自行配置环境，也可领取管理员准备好的配置文件接入。

本地 STDIO MCP · 六工具 · MIT · 当前预发布版本 0.5.0-beta.1。验证状态

为什么选择它

Agent 已经做好了页面，分享却还要传附件、解释如何打开、手动上传和管理链接。这个工具把这些后续操作接回对话，让使用者继续专注于内容。

• 专注单 HTML：围绕发布、同链接更新、查询、下线和恢复提供六项操作；不要求为每份产物建立工程或配置构建流程。

• 接入不绑定 Agent 品牌：CLI、IDE 或桌面客户端只要能启动本地 STDIO MCP，就可按各自格式配置；具体支持情况见 Agent 接入指南。

• 配置可以整份交付：管理员准备好环境和 credentials.env，使用者放好文件并接入，无需拆分填写云参数或登录 CloudBase 控制台。

• 本地产物与自己的云环境：HTML 源文件留在本地，内容发布到自己的 CloudBase 静态托管；无需另行部署远程 MCP 服务或业务数据库。

这里的轻量指单文件工作流和维护范围集中；不表示安装体积、速度或 Token 消耗优于其他工具。若 Agent 的内置发布已满足需求，可以继续使用；需要自己的云环境、统一发布方式和后续管理时，再选择本工具。

CloudBase（腾讯云开发） 提供云端托管能力。本项目聚焦已有单页产物的分享与管理；与通用 CLI、其他发布工具的关系见 定位与相近工具。

Related MCP server: publish-artifacts-mcp

典型场景

publish_html 发布或更新在线页面；offline_html 删除云端内容并保留登记；online_html 从本次指定的本地文件恢复。

hosting_status 检查接入，get_html 查询单页，list_html 查看本地已知站点。域名映射不变时，更新和恢复保持 URL 不变；公网验证与存储成功分别报告，默认域名可能有预览限制，见 适用范围。

本版新增：发布时可设置站点名称、自动提取 HTML 标题；按名称、标题或来源文件名搜索。资源诊断列出静态引用及本地检查结果，仍只上传原 HTML，不自动内嵌资源。详见 资源诊断与站点检索。已发布到 npm 的 beta 标签；请使用下方固定版本配置。

快速接入

主线是 Node.js 22+ → 准备配置文件 → 添加本地 MCP → 验证。可 让 Agent 自主接入，也可按下方 JSON 手工配置。

1. 准备 Node.js 22+。

2. 已收到完整 credentials.env，直接按 文件放置说明 操作；使用自己的环境则先 获取 API Key 并填写模板。默认位置为运行 MCP 的用户主目录下 .config/cloudbase-html-mcp/credentials.env。

3. 支持 mcpServers 的客户端可按运行 MCP 的操作系统使用下面的配置；CLI 命令、YAML 或其他 JSON 结构见 Agent 接入指南。已有 mcpServers 时只合并 cloudbase_html 条目，保留其他连接器；这个 JSON 不需要填 Key。

macOS · JSON 文件

{
  "mcpServers": {
    "cloudbase_html": {
      "command": "npx",
      "args": ["-y", "cloudbase-html-mcp@0.5.0-beta.1", "serve"]
    }
  }
}

Windows · JSON 文件

{
  "mcpServers": {
    "cloudbase_html": {
      "command": "cmd.exe",
      "args": ["/d", "/c", "npx", "-y", "cloudbase-html-mcp@0.5.0-beta.1", "serve"]
    }
  }
}

不同 Agent 的配置文件外层结构和重载方式可能不同，不能只靠这份 JSON 判断兼容性。客户端适配示例与实测证据分开维护，实测记录见 CHANGELOG。配置文件和 HTML 都须在 MCP 执行环境中可访问，见 运行位置。

保存并重载 MCP，然后让 Agent 调用 hosting_status、list_html 验证。确认目标环境后，即可说：

将 /absolute/path/report.html 发布到我配置的 CloudBase 环境，给我链接和验证结果。

详见 快速开始。源码或本地包 和可选终端向导适合开发与排错。

工具

更新或下线前先查询并传入返回的哈希。详见 示例 和 工具契约；MCP 工具发现也会提供参数说明。

CloudBase 在这里做什么

本工具使用 CloudBase 的 静态网站托管 和环境 API Key 认证，上传 HTML 并核对路由与公网访问结果。MCP 由 Agent 客户端启动为本地进程，云端使用已配置的托管资源。工具采用 MIT 开源，CloudBase 套餐、存储和流量费用另按云服务规则计算。

适用范围

• 上传单份非空 UTF-8 .html/.htm 文件，最多 20 MiB；关联的本地图片、CSS、JS 不会一起上传，发布前应确认页面可独立使用。

• 发布产生公网访问链接。本工具不提供读者登录、密码保护或协同编辑；请发布适合通过公网链接分享的内容。

• 本地文件是内容来源。不备份 HTML、不新增项目快照；列表/下线/恢复依赖本地登记，不跨机器同步。多人可使用同一环境，但各自的目录和搜索不会自动汇总，也不提供成员级站点隔离。

• 下线删除云端内容，保留本地文件才能恢复；不清除浏览器/CDN 缓存。COS 原生版本控制启用、暂停或无法核实时，会阻止破坏性清理。

• 存储成功与公网验证分开。默认域名可能出现提示页或触发下载；PUBLISHED_PREVIEW 表示内容一致但有预览限制，正式分享体验见 状态说明。

文档与开发

• 快速开始：自行配置或领取文件、Agent 自主接入或手工配置、可选向导及排错。

• Agent 接入指南：CLI、IDE、桌面客户端的接入格式与实际兼容性状态。

• 架构说明：组件、契约、数据模型与生命周期时序。

• 更新日志：各版本变更与验证证据 · 源码开发、升级与旧快照清理 · 项目边界与验证状态。

npm ci --ignore-scripts
npm run test:prepare
npm run check
npm test

test:prepare 联网准备独立 npm 测试缓存；npm test 离线，包含真实 STDIO 子进程及本地安装包测试，云端使用替身。依赖变更或缓存清理后重新准备。CI 与桌面客户端、真实云端验收分开记录。

许可证

MIT。依赖遵循各自许可证。本项目为独立工具，不是腾讯云官方产品。