AgentMatter
EN/中文
提交项目GitHub
MCP 服务器 · 发布者仓库

MarkItDown-MCP

MarkItDown-MCP 是 Microsoft MarkItDown 仓库中的 MCP 服务器，通过一个 `convert_to_markdown(uri)` 工具把本地文件、网页或 data URI 转换为适合 LLM 处理的 Markdown。

176.2k StarsMITPython6 天前更新
安装与使用 GitHub
01

项目介绍

MarkItDown-MCP 把 Microsoft 的文档转换工具包装成一个本地 MCP 服务器。Agent 只需调用 `convert_to_markdown(uri)`，就能把 PDF、Office 文档、网页或其他受支持输入转换成结构化 Markdown。它非常适合把文件交给 LLM 阅读，但因为可以读取当前用户能访问的文件，权限边界必须收紧。

02

核心功能

01

文件转 Markdown

把受支持的本地文件或远程 URI 转换为保留标题、列表、表格和链接的 Markdown。

02

网页与 URI 转换

通过默认 STDIO 连接到本地 MCP 客户端。

03

本地 STDIO 连接

可选择 Streamable HTTP 或 SSE，但默认仅监听 localhost。

04

Inspector 调试

使用 MCP Inspector 列出工具并调用 `convert_to_markdown` 做最小验证。

MarkItDown-MCP README 展示使用 MCP Inspector 连接和调试服务器的步骤
调试说明覆盖 STDIO、Streamable HTTP 和 SSE，并引导用户列出和调用 convert_to_markdown 工具。查看仓库原图
03

安装与连接

优先使用本地 Python 虚拟环境和 STDIO；只给服务器一个测试目录，先转换无敏感信息的小文件，再考虑接入真实资料。

AI AGENT INSTALL

让 AI Agent 帮你安装

把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。

请帮我安装 MarkItDown-MCP。项目地址：https://github.com/microsoft/markitdown，组件说明：https://github.com/microsoft/markitdown/blob/main/packages/markitdown-mcp/README.md。先读取组件 README、根 README 和 LICENSE，在独立 Python 虚拟环境中运行 `pip install markitdown-mcp`，优先配置 STDIO 命令 `markitdown-mcp`。只使用我指定的无敏感测试目录，不要把 HTTP/SSE 绑定到非 localhost。遇到安装额外依赖、读取其他目录、访问需要登录的网址、配置网络监听、凭据、额外权限或覆盖文件时先询问我。最后用 MCP Inspector 列出工具并转换一个测试文件。
01开始前准备
  • 可用的 Python 与 pip
  • 支持 MCP STDIO 的客户端
  • 准备一个不含敏感信息的测试文件
02复制安装命令或配置
pip install markitdown-mcp
03按步骤完成安装
  1. 1
    创建隔离环境并安装

    在独立 Python 环境中运行 `pip install markitdown-mcp`。

  2. 2
    配置本地 STDIO

    在 MCP 客户端中把命令设置为 `markitdown-mcp`，先不启用 HTTP/SSE。

  3. 3
    用测试文件验证

    通过 MCP Inspector 列出工具，再调用 `convert_to_markdown` 转换无敏感信息的测试文件。

如何确认安装成功

启动 `markitdown-mcp` 后用 MCP Inspector 选择 STDIO、命令填写 `markitdown-mcp`，连接后列出工具并调用 `convert_to_markdown` 转换测试文件；看到结构化 Markdown 才算通过。

使用前注意
  • 优先 STDIO 与最小文件权限
  • 不要把无认证服务暴露到外部网络
MarkItDown-MCP README 展示 pip 安装、STDIO 和本地 HTTP 启动命令
组件支持 pip 安装，默认使用 STDIO，也提供绑定 127.0.0.1 的 Streamable HTTP 与 SSE 方式。查看仓库原图
04

使用场景

SCENARIO 01

让 Agent 阅读办公文件

把 PDF、Word、PowerPoint 或 Excel 内容转换为适合 LLM 的 Markdown。

SCENARIO 02

网页与 URI 整理

把公开网页或其他受支持 URI 统一转换为文本结构。

SCENARIO 03

本地知识处理

在受限本地目录中为摘要、检索或问答准备 Markdown。

05

使用评价

MarkItDown-MCP 的优势是用途直观、安装简单、仓库成熟，并且同时支持 STDIO 与可选网络传输。最重要的限制是它以当前用户权限读取文件且没有认证，因此最适合可信本地 Agent 和受限目录。本评价来自组件 README、根 README、源码结构、release 和 MIT 许可证，未运行真实转换。

值得一试的地方

  • 安装命令简单
  • 支持常见文档到 Markdown 工作流
  • README 清楚说明本地绑定和文件权限风险

使用前要知道

  • 无认证且可读取本地文件
  • 高保真排版不是目标
  • 本次未安装和实测
06

README

MarkItDown-MCP

Overview

MarkItDown-MCP 是 Microsoft MarkItDown 仓库中的 MCP 服务器，通过一个 `convert_to_markdown(uri)` 工具把本地文件、网页或 data URI 转换为适合 LLM 处理的 Markdown。 Python tool for converting files and office documents to Markdown.

Getting started

  • 优先使用本地 Python 虚拟环境和 STDIO；只给服务器一个测试目录，先转换无敏感信息的小文件，再考虑接入真实资料。
  • 组件提供一个 `convert_to_markdown(uri)` 工具，接受 `http:`、`https:`、`file:` 或 `data:` URI。
  • 安装命令为 `pip install markitdown-mcp`，默认以 `markitdown-mcp` 启动 STDIO。
  • 启动 `markitdown-mcp` 后用 MCP Inspector 选择 STDIO、命令填写 `markitdown-mcp`，连接后列出工具并调用 `convert_to_markdown` 转换测试文件；看到结构化 Markdown 才算通过。

Configuration

pip install markitdown-mcp
在 GitHub 阅读完整 README →