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 分