← 返回目录

Markdownify MCP Server

社区

将多种文件和网页内容转换为 Markdown。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 150 / 230
Stars: ★ 3.0k 非常热门
传输方式: stdio（本地进程）
运行环境: Bun · Node.js · Python
凭据: 无需凭据
许可证: MIT
最近提交: 5 个月前
工具数: 10

50FMRS · D

这是一个 MIT 许可的社区 MCP 服务器，重点是把多种文件、网页内容和部分媒体内容转换为 Markdown。README 提供了构建、启动、桌面应用配置和路径限制说明，但未提供已验证的具体客户端兼容性列表或服务器清单。

最强项 · 文档质量 13/20 最弱项 · 维护活跃度 7/20

可靠性

8/20

安全与权限

11/20

维护活跃度

7/20

文档质量

13/20

安装易用性

11/20

查看各项评分依据

可靠性 8/20: README 提供了 Bun 安装、构建、启动流程和工具清单，且声明了 MarkItDown、Repomix 等依赖；因此正常路径看起来可行。但未提供服务器清单、源文件、CI、提交测试或握手验证证据，Python 虚拟环境和 Docker 精简镜像还存在依赖差异，无法确认工具声明与实际行为完全一致，故扣分。
安全与权限 11/20: 工具主要执行文件和网页内容转换，没有显示删除、支付、部署或远程命令功能，也没有要求凭据，未触及安全红线。README 显示网页、YouTube 和 Bing 工具会访问外部网络；本地文件访问默认不受限，MD_ALLOWED_PATHS 只是可选配置，且没有源代码证据证明路径校验、输入限制、网络范围或数据流处理细节，因此扣分。
维护活跃度 7/20: 仓库标记为未归档，并提供 MIT 许可证；开放 issue 数量只能作为发现信号，不能证明维护质量。没有提供发布记录、提交频率、问题响应、依赖更新、安全响应渠道或明确维护者信息，持续维护证据不足，故仅给低中分。
文档质量 13/20: README 覆盖安装、构建、启动、桌面客户端配置、工具名称、环境变量、Docker 挂载方式和精简镜像功能限制，文档可用性较好。未说明各工具的参数、返回格式、认证需求、资源/成本限制、错误处理和系统级故障排查；manifest 也未缓存，故未给高分。
安装易用性 11/20: README 给出了从 Bun 安装到构建启动的步骤，并提供主流桌面客户端配置示例和 Docker 方案。流程仍依赖 Bun、Node 配置、Python 虚拟环境及外部命令，平台差异和依赖失败处理未被验证，也没有 CI 或测试证明可连接，故评为可行但偏手工。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件访问网络

适合谁

需要统一整理多种文件格式和网页内容的用户。
需要在本地 MCP 桌面应用中使用 Markdown 转换工具的用户。
能够配置 Bun、Node.js 和 Python 依赖的开发者。

不适合谁

只需要结构化数据库或云存储操作的用户。
需要已明确证明支持特定 MCP 客户端的用户。
使用精简 Docker 镜像且需要音频转录或图片 OCR 的用户。

所需权限

服务器需要读取传入的文件路径；可使用 MD_ALLOWED_PATHS 限制所有文件输入工具可读取的目录。
未设置 MD_ALLOWED_PATHS 时，文件读取范围默认不受限制。
处理网页、YouTube 或 Bing 内容的工具需要访问相应的网络内容；源材料未说明额外认证要求。

风险与副作用

默认文件读取范围不受限制，配置 MD_ALLOWED_PATHS 可缩小读取边界。
Docker 发布镜像仅安装 markitdown[pdf]；音频转录和图片 OCR 工具在该精简镜像中会失败。
将本地目录挂载到 Docker 时，应只挂载需要读取的目录，并使用容器内路径。

安装接入

准备工作

运行环境：Bun · Node.js · Python

其他可选配置项（4 个）

MARKITDOWN_PATH 可选 markitdown 可执行文件的绝对路径；当 markitdown 不在项目自带 .venv 或 PATH 中时设置。

REPOMIX_PATH 可选 repomix 可执行文件的绝对路径，供 git-repo-to-markdown 使用；不在 PATH 时设置。

MD_ALLOWED_PATHS 可选以冒号（Windows 用分号）分隔的目录列表，限制所有文件输入工具只能读取这些目录。

MD_SHARE_DIR 可选 MD_ALLOWED_PATHS 的已弃用别名（仅单个目录），仅为向后兼容保留。

克隆仓库；运行 bun install 安装依赖；运行 bun run build 构建项目；运行 bun start 启动服务器。桌面应用配置应将 command 设置为 node，并将 dist/index.js 的绝对路径放入 args。

MCP 配置 · JSON

{"mcpServers":{"markdownify":{"command":"node","args":["{ABSOLUTE PATH TO FILE HERE}/dist/index.js"]}}}

适用于使用 mcpServers 字段的客户端。VS Code 等使用其他字段的客户端，可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "markdownify": {
      "command": "node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add markdownify -- node '{ABSOLUTE PATH TO FILE HERE}/dist/index.js'

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端的 MCP 工具列表中应能看到 youtube-to-markdown、pdf-to-markdown、get-markdown-file 等工具；可输入“用 bing-search-to-markdown 搜索 Model Context Protocol”来验证连通性。

常见排障

确认已运行 bun install 和 bun run build。
确认使用 bun start 启动服务器，并在客户端配置 dist/index.js 的绝对路径。
如 markitdown 不在默认虚拟环境中，检查 MARKITDOWN_PATH 或系统 PATH。
如 git-repo-to-markdown 相关功能异常，检查 REPOMIX_PATH 或系统 PATH。
Docker 中确认工具使用的是容器路径，并检查 MD_ALLOWED_PATHS 是否包含挂载目录。
需要音频转录或图片 OCR 时，确认使用本地完整安装，而不是仅含 PDF 依赖的 Docker 镜像。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

把 https://www.youtube.com/watch?v=xxx 这个视频的字幕转成 Markdown
帮我把我桌面上的 report.pdf 转成 Markdown
用 Bing 搜索“Model Context Protocol”并把结果转成 Markdown
读取 /data/notes.md 并把内容展示给我

工具能力 10

youtube-to-markdown 只读

将 YouTube 视频转换为 Markdown。

pdf-to-markdown 只读

将 PDF 文件转换为 Markdown。

bing-search-to-markdown 只读

将 Bing 搜索结果转换为 Markdown。

webpage-to-markdown 只读

将网页内容转换为 Markdown。

image-to-markdown 只读

将图片转换为包含元数据的 Markdown。

audio-to-markdown 只读

将音频文件转录并转换为 Markdown。

docx-to-markdown 只读

将 DOCX 文件转换为 Markdown。

xlsx-to-markdown 只读

将 XLSX 文件转换为 Markdown。

展开其余 2 个工具

pptx-to-markdown 只读

将 PPTX 文件转换为 Markdown。

get-markdown-file 只读

读取现有 Markdown 文件；文件扩展名必须为 .md 或 .markdown。

使用场景

将办公文档、PDF、演示文稿和表格转换为可读 Markdown。

从图片和音频中提取内容，其中音频支持转录。

将网页、YouTube 视频字幕或 Bing 搜索结果整理为 Markdown。

读取已有的 Markdown 文件。

详细介绍

Markdownify 是一个 Model Context Protocol（MCP）服务器，可将 PDF、图片、音频、DOCX、XLSX、PPTX、网页及部分搜索和视频内容转换为 Markdown，也可读取现有 Markdown 文件。