用途：html-to-markdown MCP 服务器把转换器的 HTML 转换与元数据提取能力暴露为 MCP 工具，使 MCP 兼容客户端（如 Claude Code、Claude Desktop）无需调用 CLI 或编写胶水代码，就能直接转换 HTML 并获取结构化元数据。
主要能力：提供 convert_html 与 extract_metadata 两个工具。convert_html 接收 HTML 字符串、可选的、与 ConversionOptions 对应的 config 对象和可选的 json 标志；设置 json: true 时返回完整 ConversionResult（内容包括 content、tables、metadata、文档结构、内联图片、warnings），否则只返回转换后的文本。extract_metadata 仅接收 html，用于提取结构化元数据（文档信息、Open Graph / Twitter / JSON-LD / Microdata、headers、links、images）。两个工具都只接收 HTML 字符串，不抓取 URL 或读取文件（那属于 CLI 能力）。
使用方式：插件会自动注册服务器，其命令为内置启动脚本 scripts/mcp-launch.sh，该脚本执行 html-to-markdown mcp。首次运行时，启动器会解析 html-to-markdown 二进制：优先复用 PATH 中的或插件 bin/ 中已缓存的，然后尝试 npx/uvx，再尝试 Homebrew，最后从该工具最新 GitHub 发行版下载预构建版本。可用 HTML_TO_MARKDOWN_LAUNCHER=auto|npx|uvx|brew|download 覆盖渠道。手动运行命令为 html-to-markdown mcp（供 Claude Code / Claude Desktop 使用，走 stdio）。工具的确切参数模式以运行中的服务器为准，可让客户端列出工具查看实际接口。
适用场景：在智能体会话内优先用 MCP，智能体可直接把转换器作为工具调用，无需 shell 调用和进程管理；一次性转换和 shell 管道（如配合 jq）优先用 CLI；把转换嵌入应用代码时优先用 SDK。
限制：mcp 子命令随该工具较新版本发布；若 PATH 中已有旧版 html-to-markdown，可能尚未暴露 mcp，需要升级二进制（brew upgrade、重新下载或重新构建）。MCP 服务器本身不抓取 URL、不读取文件。