mcpField
R
readdown-mcp

readdown-mcp

本地服务
github.com/zcag浏览器自动化033 周前更新
代码仓库

关于 readdown-mcp

readdown-mcp 是一个 MCP 服务，可将网页或提供的 HTML 转换为适合 LLM 使用的简洁 Markdown。它通过 HTTP 获取网页，无需浏览器，并提供元数据和 token 估算。

主要功能

  1. 01获取 URL 并转换网页为 Markdown
  2. 02将提供的 HTML 转换为 Markdown
  3. 03提取标题、作者和日期
  4. 04估算输出 token 数量

适用场景

  1. 01为 LLM 处理准备网页内容
  2. 02将现有 HTML 内容转换为 Markdown
  3. 03查看网页元数据和预估 token 用量

MCP 相关

它向 MCP 客户端提供 URL 获取和 HTML 转 Markdown 工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "zcag-readdown": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/zcag/readdown-mcp:1.0.0"
      ]
    }
  }
}
启动命令docker run -i --rm ghcr.io/zcag/readdown-mcp:1.0.0

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
ocighcr.io/zcag/readdown-mcp:1.0.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

readdown-mcp

用于将网页转换为简洁、针对大模型优化的 Markdown 的 MCP 服务。

轻量级——使用 HTTP 获取，无需浏览器。由 readdown 提供支持。

工具

fetch_markdown

获取 URL，并将其转换为带有元数据和令牌数量的简洁 Markdown。

convert_html

将 HTML 字符串转换为 Markdown。适用于已有 HTML 的情况。

安装

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "readdown": {
      "command": "npx",
      "args": ["-y", "github:zcag/readdown-mcp"]
    }
  }
}
Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "readdown": {
      "command": "npx",
      "args": ["-y", "github:zcag/readdown-mcp"]
    }
  }
}

为什么选择 readdown？

大多数网页获取 MCP 服务使用 @mozilla/readability + turndown（两个软件包，共 65KB）。 readdown 用一个 5KB 的软件包取代两者，并提供更好的大模型优化：

  • 令牌效率高的输出（令牌更少 = API 调用成本更低）
  • 内置令牌估算
  • 元数据提取（标题、作者、日期）
  • 可在服务器端与 linkedom 配合使用（无需浏览器 DOM）

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。