using-the-mcp-server
Use when converting HTML to Markdown or extracting metadata and tables through the html-to-markdown MCP server's tools, rather than shelling out to the CLI. Covers the tool surface, the auto-installing launcher, and when MCP beats the CLI or SDK.
来源信息
- 仓库
- xberg-io/html-to-markdown
- 最近来源活动
- 2026年10月6日 15:47
- 检测到的 SKILL.md 语言
- 英语
- 星标
- 881
- 分支
- 74
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- name
- using-the-mcp-server
- description
- Use when converting HTML to Markdown or extracting metadata and tables through the html-to-markdown MCP server's tools, rather than shelling out to the CLI. Covers the tool surface, the auto-installing launcher, and when MCP beats the CLI or SDK.
<!--
AI-RULEZ :: GENERATED FILE — DO NOT EDIT
Content-Hash: blake3:c6276d5c9515b3ea110d1f483a3c0ac259c4edb0b9e298431f5644d1c4103c66
Source-Hash: blake3:ee7b42dfe0189be4c8fc402a02da63aad9356731f32835e48c1312669d63bf3b
Schema-Version: v1
-->
# Using the MCP Server
The `html-to-markdown` MCP server exposes the converter's conversion and
metadata-extraction capabilities as MCP tools, so an MCP-compatible client (Claude
Code, Claude Desktop) can convert HTML and pull structured metadata directly,
with no CLI invocation or glue code.
## How it runs in this plugin
The plugin auto-registers the server. Its command is the bundled launcher
`scripts/mcp-launch.sh`, which execs `html-to-markdown mcp`. On first run the
launcher resolves an `html-to-markdown` binary: it reuses one already on `PATH`
or cached in the plugin's `bin/`, then tries `npx`/`uvx`, then Homebrew, then
downloads a prebuilt from the tool's latest GitHub release. Override the channel
with `HTML_TO_MARKDOWN_LAUNCHER=auto|npx|uvx|brew|download`.
The `mcp` subcommand ships in a recent release of the tool. If an older
`html-to-markdown` is already on `PATH`, it may not expose `mcp` yet — upgrade
the binary (`brew upgrade`, re-download, or rebuild) to pick it up.
To run it manually:
```bash
html-to-markdown mcp # for Claude Code / Claude Desktop (stdio)
```
## The tools
- **convert_html** — convert an HTML string to Markdown, Djot, or plain text.
Takes `html` (the HTML string), an optional `config` object mirroring
`ConversionOptions`, and an optional `json` flag. With `json: true` it returns
the full `ConversionResult` (content, tables, metadata, document structure,
inline images, warnings) instead of the bare converted text.
- **extract_metadata** — pull structured metadata (document info, Open
Graph / Twitter / JSON-LD / Microdata, headers, links, images) from an HTML
string. Takes only `html`.
Both tools accept an HTML **string** — the MCP server does not fetch URLs or read
files (that is CLI-only). The exact argument schemas come from the running
server; ask the client to list tools to see the live surface.
## When to prefer MCP over the CLI or SDK
- **Prefer MCP** inside an agent session: the agent calls the converter directly
as a tool, with no shell-out and no process management.
- **Prefer the CLI** for one-shot conversions and shell pipelines (`… | jq`).
- **Prefer the SDK** when embedding conversion in application code.
在 GitHub 查看