MCP 集成

阅读约 1 分钟

md2html 提供一个 stdio MCP server，让 agent（Claude Code、Cursor、Cline、n8n）直接调用。

一行装

在你的 MCP 配置（如 ~/.claude/mcp.json 或项目 .mcp.json）添加：

{
  "mcpServers": {
    "md2html": {
      "command": "npx",
      "args": ["-y", "@md2html-cli/md2html-mcp"],
      "env": {
        "DEEPSEEK_API_KEY": "sk-...",
        "ZHIPU_API_KEY": "..."
      }
    }
  }
}

重启 agent 客户端，4 个 tool 立即可用。

4 个 tool

md2html_build

输入：

字段 类型 必填 说明
source string yes markdown 源
theme “default” | “academic” | “minimal” no 主题
inline boolean no 是否把 asset 都 inline 进单 HTML

输出 { html, errors[], warnings[], cost }。

md2html_publish

像 md2html_build 但发布到配置的 target（cloudflare / github / netlify / s3），返回 URL。

md2html_list_providers

返回当前 env 配好的所有 LLM / image / publish provider 清单。agent 自检"我能用哪些"。

md2html_extract

反向：从已生成的 HTML 抽出结构化数据（标题、章节列表、表格、图表）。供 agent 多轮处理。

典型 agent 工作流

flowchart TD
  A[agent 接到任务] --> B[写 markdown]
  B --> C[md2html_build]
  C --> D[返回 HTML]
  D --> E[md2html_publish]
  E --> F[给用户 URL]

后续