HTML Share MCP Server

MCP Server for HTML Share Service，让 AI Agent 通过 MCP 协议操作 HTML 分享服务。

功能

| Tool | 说明 | |------|------| | html_share_publish | 发布 HTML 内容，返回分享链接 | | html_share_list | 列出当前用户的所有已发布文件 | | html_share_get_link | 按 ID 或名称获取文件分享链接 | | html_share_update_visibility | 修改文件可见性（public/private） | | html_share_delete | 删除文件 |

前提

1. HTML Share Service 已部署并可访问
2. 已在 Web UI 的 Profile 页生成 API Token（hsp_ 开头）

安装

# 全局安装（推荐）
npm install -g ./mcp-server/

# 或不安装，通过 npx 直接运行
npx ./mcp-server

配置

环境变量

| 变量 | 必填 | 说明 | |------|------|------| | HTML_SHARE_URL | 是 | 服务地址，如 https://share.example.com | | HTML_SHARE_TOKEN | 是 | API Token，以 hsp_ 开头 |

Claude Code / Codex / Cursor

在项目 .mcp.json（或 Claude Code 全局 ~/.claude.json、Codex ~/.codex/config.json）中添加：

{
  "mcpServers": {
    "html-share": {
      "command": "npx",
      "args": ["-y", "html-share-mcp"],
      "env": {
        "HTML_SHARE_URL": "https://share.example.com",
        "HTML_SHARE_TOKEN": "hsp_your_token_here"
      }
    }
  }
}

安全提示：建议通过环境变量引用 token 而非明文写入配置文件。确保 .mcp.json 在 .gitignore 中。

Cursor 也可在 Settings → MCP Servers UI 中手动添加，配置同上。

使用示例

配置完成后，Agent 可直接调用：

用户: 把这段报表 HTML 发布到分享系统
Agent: [调用 html_share_publish] → 已发布，链接: https://share.example.com/s/abc123

用户: 我发布过哪些文件？
Agent: [调用 html_share_list] → 你有 3 个文件: ...

用户: 把第一个改成公开
Agent: [调用 html_share_update_visibility] → 已设为 public