ezmd

io.github.larpey由 GitHub 账号 larpey 发布v0.1.1更新于 Oct 24, 2026

Convert files, URLs and text to LLM-ready Markdown with paging, provenance and warnings.

已验证STDIO仅桌面网页搜索与抓取文件与存储

概览

AI 生成的概览

本地 MCP 服务器，将文件、URL 和粘贴文本转换为适合 LLM 的 Markdown，支持分页、章节编号和警告。

可以做什么
将 http(s) URL 转换为 Markdown，经 SSRF 防护抓取，按 token 预算分页，并附带来源标记和跳过或截断内容的警告。转换允许目录内的本地文件，或小于 1 MB 的 base64 data URL。转换粘贴的文本、HTML、Markdown、CSV 或 JSON。通过基于游标的作业工具翻页查看结果并查询作业状态。列出支持的类型、缺失的附加组件、限制以及是否允许抓取。
适用场景
适合需要让助手把网页、本地文档或粘贴内容读成干净 Markdown 以便摘要或引用的场景，尤其是输出需控制在 token 预算内并引用章节编号和页码时。
运行要求
作为本地 stdio 进程运行，通过 uvx 从 PyPI 包 ezmd-mcp 启动，需要 Python 和 uv。可选设置：EZMD_MCP_ALLOWED_DIRS 指定可读目录（默认为工作目录），EZMD_PROFILE 指定默认输出配置，EZMD_REMOTE 与 EZMD_API_KEY 用于将转换转发到远程 ezmd 实例。URL 转换需要网络访问。
安装前请注意
URL 转换会抓取远程内容，可能包含提示注入；服务器会将疑似注入作为警告报告，但抓取的文本仍不可信。EZMD_API_KEY 是密钥，会作为 X-API-Key 请求头发送给配置的远程实例。EZMD_MCP_ALLOWED_DIRS 决定可读取哪些本地文件，应保持范围最小。HTTP 传输模式需要 bearer token。

安装

在 SourceWeft 中

  1. 打开 控制台中的 ezmd，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

ezmd-mcp

An MCP server for ezmd: convert files, URLs and pasted text to LLM-ready Markdown from Claude Desktop, Claude Code, Cursor, VS Code and any other MCP client. Results are paginated to your token budget, carry section ids and page markers for citations, and report every warning (skipped pages, truncated tables, suspected prompt injection) instead of dropping content silently.

bash
uvx ezmd-mcp                      # stdio, converts in-processuvx ezmd-mcp --allowed-dirs ~/docsuvx ezmd-mcp --remote https://ezmd.example   # forward to an instance; EZMD_API_KEY is sent as X-API-Keyuvx ezmd-mcp --transport http --port 8765      # streamable HTTP on 127.0.0.1, bearer token required

Tools

ToolWhat it does
convert_url(url, profile?, max_tokens?, options?)Fetch (through the SSRF guard) and convert an http(s) URL.
convert_file(path? | data_url?, profile?, max_tokens?, options?)Convert a local file inside the allowed directories, or a base64 data: URL under 1 MB.
convert_text(text, source_hint?, profile?, max_tokens?)Convert pasted text, HTML, Markdown, CSV, JSON.
get_job(job_id, cursor?, max_tokens?, profile?)Job status, or the page at cursor: the pagination endpoint for every convert tool.
list_capabilities()Supported types, missing extras, limits, whether fetching is allowed.

Every result has job_id, title, source, tokens_total, pages_total, page, next_cursor, warnings, frontmatter, content (page 1 adds sections). The default profile is agent (untrusted-content fence, section ids); max_tokens defaults to 8000 and is capped at 50000. Resources ezmd://jobs/{id} and ezmd://jobs/{id}/sidecar expose the full Markdown and sidecar JSON; the prompt summarize_with_provenance asks the model to cite section ids and pages.

See docs/mcp.md for client configuration, security notes and every option. Apache-2.0.

来源：packages/mcp/README.md，提交 b138ab9

工具

0
SourceWeft 曾在隔离沙箱中以无凭据方式启动该软件包一次，以列出其工具，但未能完成：软件包安装失败。

版本历史

2
  1. v0.1.1最新Oct 23, 2026
  2. v0.1.0Oct 20, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分