ezmd

本地服务

github.com开发工具1今天更新

代码仓库访问官网

关于 ezmd

ezmd-mcp 将文件、URL 和粘贴文本转换为适用于 LLM 工作流的分页 Markdown。它保留章节和页码引用，并报告跳过页面、表格截断及疑似提示词注入等问题。

主要功能

01将文件、URL 和文本转为 Markdown
02按令牌预算分页输出
03附带章节 ID 和页码标记
04报告转换警告
05将任务结果作为资源公开

适用场景

01准备网页以供 LLM 分析
02转换本地文档以便引用
03检查转换内容中的警告

MCP 相关

它提供 URL、文件和文本转换、任务分页及能力查询等 MCP 工具，也将完整 Markdown 和 sidecar JSON 作为资源公开，并包含强调来源追溯的提示词。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "larpey-ezmd": {
      "command": "uvx",
      "args": [
        "ezmd-mcp"
      ],
      "env": {
        "EZMD_PROFILE": "<EZMD_PROFILE>",
        "EZMD_MCP_ALLOWED_DIRS": "<EZMD_MCP_ALLOWED_DIRS>",
        "EZMD_REMOTE": "<EZMD_REMOTE>",
        "EZMD_API_KEY": "<EZMD_API_KEY>"
      }
    }
  }
}

启动命令uvx ezmd-mcp

需要配置的环境变量

EZMD_PROFILEDefault output profile: full, compact, rag or agent

EZMD_MCP_ALLOWED_DIRSDirectories convert_file may read, separated by the OS path separator (default: working directory)

EZMD_REMOTEBase URL of an ezmd instance; converts there instead of in-process

EZMD_API_KEY密钥API key for EZMD_REMOTE, sent as X-API-Key

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

安装包

pypiezmd-mcp0.1.1stdio

工具

收录的工具列表 · 更新于 5 天前

参数	类型	必填
url	string	是
options	any	否
profile	any	否
max_tokens	any	否

详细介绍

ezmd-mcp

一个适用于 ezmd 的 MCP 服务：可在 Claude Desktop、Claude Code、Cursor、VS Code 和任何其他 MCP 客户端中，将文件、URL 和粘贴的文本转换为适合大模型使用的 Markdown。结果会按令牌预算分页，并附带章节 ID 和页面标记以供引用，同时报告所有警告（跳过的页面、被截断的表格、疑似提示词注入），而不是悄悄丢弃内容。

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

工具

工具	功能
`convert_url(url, profile?, max_tokens?, options?)`	通过 SSRF 防护机制获取并转换 http(s) URL。
`convert_file(path? \| data_url?, profile?, max_tokens?, options?)`	转换允许目录中的本地文件，或不超过 1 MB 的 base64 `data:` URL。
`convert_text(text, source_hint?, profile?, max_tokens?)`	转换粘贴的文本、HTML、Markdown、CSV、JSON。
`get_job(job_id, cursor?, max_tokens?, profile?)`	获取任务状态，或获取 `cursor` 指向的页面：这是所有转换工具的分页端点。
`list_capabilities()`	查看支持的类型、缺失的额外组件、限制，以及是否允许获取内容。

每个结果都包含 job_id, title, source, tokens_total, pages_total, page, next_cursor, warnings, frontmatter, content（第 1 页还会添加 sections）。默认配置文件为 agent（不可信内容边界标记、章节 ID）；max_tokens 默认为 8000，上限为 50000。资源 ezmd://jobs/{id} 和 ezmd://jobs/{id}/sidecar 提供完整的 Markdown 和 sidecar JSON；提示词 summarize_with_provenance 会要求模型引用章节 ID 和页码。

有关客户端配置、安全说明和所有选项，请参阅 docs/mcp.md。Apache-2.0。

支持 Markdown

登录后评论