MarkItDown MCP Server
微软官方出品的文档转 Markdown 工具 MarkItDown 的 MCP Server(PyPI 包 markitdown-mcp):把 PDF、Word、Excel、PowerPoint、图片、音频转写、HTML、Outlook 邮件、YouTube 字幕等常见格式统一转成 Markdown,供 LLM 直接消费。对 Agent 只暴露一个工具 convert_to_markdown(uri),uri 支持 http:/https:/file:/data: 四种形态,本地与远程文件都能转。
MarkItDown 本体是 CLI 与 Python 库双形态(markitdown file.pdf > doc.md,或库内 MarkItDown().convert()),格式依赖按 extra 按需安装(全量装:pip install 'markitdown[all]'),并支持第三方插件扩展新格式;MCP Server 默认 stdio 传输,也支持 Streamable HTTP / SSE(默认仅绑定 localhost)。
MCP 客户端接入:下方配置片段用 uvx 免安装直跑;已 pip install markitdown-mcp 的用户可把 command 简化为 markitdown-mcp(官方 STDIO 用法),Docker 形态与安全说明见仓库 packages/markitdown-mcp 的 README。
中文实测记录
awesome-mcp-servers 清单条目(File Systems 段)增量补抓:v1 批次漏收——清单链接为深链(/tree/main/packages/markitdown-mcp),旧解析正则只认 owner/repo 裸链。元数据 GitHub GraphQL 实时核验(185707★/Python/MIT,2026-09-20);MCP 用法以官方 packages/markitdown-mcp README 为准(pip 安装、markitdown-mcp 默认 stdio、单工具 convert_to_markdown(uri));旧口径 markitdown[mcp] extra 已拆为独立包 markitdown-mcp(PyPI 0.0.1a7,Requires-Python ≥3.10,依赖 markitdown[all])。Server 本体待实测。
{
"mcpServers": {
"markitdown": {
"command": "uvx",
"args": [
"markitdown-mcp"
]
}
}
} 