微软又整活！MarkItDown-MCP：网页/文件一键转Markdown，还能直接喂给AI用！（支持Claude)

显示全部楼层

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;padding-left: 8px;color: rgb(63, 63, 63);">导语：

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 15px;letter-spacing: 0.1em;color: rgb(63, 63, 63);">还在为手动转换网页文章、本地文档到 Markdown 格式而头疼？想不想让你的 AI 助手（比如 Claude）也能轻松读取并处理各种来源的内容？微软 AutoGen 团队带来了福音——开源项目ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: inherit;color: rgb(14, 95, 71);">MarkItDown-MCP！这款轻量级工具能将网页链接、本地文件甚至数据 URI 直接转换为干净的 Markdown，最酷的是它原生支持ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: inherit;color: rgb(14, 95, 71);">MCP (模型上下文协议)，能无缝对接 AI 模型！特别适合需要高效处理信息的学生、内容创作者以及玩转 AI Agent 的技术爱好者们！

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;padding-left: 8px;color: rgb(63, 63, 63);">正文：

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;color: rgb(14, 95, 71);">1. MarkItDown-MCP 是什么？

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 15px;letter-spacing: 0.1em;color: rgb(63, 63, 63);">简单来说，MarkItDown-MCP 是一个ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: inherit;color: rgb(14, 95, 71);">专注于格式转换的小工具，它提供了一个核心功能，并通过 MCP 协议将其暴露给 AI 或其他程序：

ingFang SC", "Hiragino Sans GB", "Microsoft YaHei UI", "Microsoft YaHei", Arial, sans-serif;font-size: 15px;text-indent: -1em;display: block;margin: 0.2em 8px;color: rgb(63, 63, 63);">
•核心工具函数:convert_to_markdown(uri)
•强大兼容性:支持多种 URI (统一资源标识符) 类型作为输入：

•http:/https:(网页链接)
•file:(本地文件路径)
•data:(Base64 编码等数据)

•MCP 支持:将转换功能封装为 MCP 工具，方便 AI 模型（如 Claude Desktop）发现和调用。
•轻量设计:专注于做好 Markdown 转换这一件事，简单高效。

2. 两种运行模式，灵活适配

MarkItDown-MCP 提供了两种运行模式，满足不同场景需求：

•① STDIO 模式 (标准输入/输出):

•运行方式:直接在命令行运行markitdown-mcp。
•优点:最简单，无需启动服务器，适合本地脚本调用或与支持 STDIO 的 MCP 客户端（如mcp-proxy或某些本地 Agent 框架）集成。

•

•运行方式:通过 HTTP 服务器提供服务，命令如markitdown-mcp --sse --host 127.0.0.1 --port 3001。
•优点:适合需要通过网络访问转换功能的场景，或者与支持 SSE 的 MCP 客户端（如 Cursor）直接连接。

3. 快速上手：安装与运行

上手非常简单：

1.安装:(需要 Python 环境)
```
pipinstallmarkitdown-mcp
```
2.运行:

•运行 STDIO 模式 (默认):
```
markitdown-mcp
```
•运行 SSE 模式 (指定地址和端口):
```
markitdown-mcp--sse--host127.0.0.1--port3001
```
(服务器将在http://127.0.0.1:3001/sse提供服务)

推荐使用 Docker来运行 MarkItDown-MCP：

1.构建 Docker 镜像:(需要安装 Docker)

• 下载项目代码 (或仅 Dockerfile)。
• 在项目根目录运行：
```
dockerbuild-tmarkitdown-mcp:latest.
```

2.

claude_desktop_config.json
文件 (具体位置请参考 Claude Desktop 文档)。

• 在mcpServers部分添加以下条目：

{
"mcpServers":{
 "markitdown":{
  "command":"docker",// 使用 docker 命令
  "args":[
   "run",  // 运行容器
   "--rm",  // 容器退出后自动删除
   "-i",   // 保持 STDIN 打开，即使没有附加 (交互模式所需)
   "markitdown-mcp:latest"// 使用你构建的镜像
  ]
 }
}
}

3.(可选) 访问本地文件:如果你想让 Claude 通过 MarkItDown-MCP 读取你电脑上的本地文件，需要在 Dockerrun命令中挂载本地目录：

• 例如，将本地的/home/user/data目录挂载到容器内的/workdir：

{
"mcpServers":{
 "markitdown":{
  "command":"docker",
  "args":[
   "run","--rm","-i",
   "-v","/home/user/data:/workdir",// 添加卷挂载
   "markitdown-mcp:latest"
  ]
 }
}
}

• 之后，你就可以让 Claude 使用file:///workdir/your_file.txt这样的 URI 来访问/home/user/data目录下的文件了。

为什么推荐 Docker？Docker 可以隔离运行环境，避免 Python 依赖冲突，并且方便管理服务的启停，特别适合与 Claude Desktop 这种需要稳定后台命令的应用集成。

5. 调试与资源

•调试工具:可以使用官方推荐的mcpinspector工具来检查 MCP 服务器是否正常工作。
```
npx@modelcontextprotocol/inspector
```
然后根据提示在浏览器中连接 STDIO 或 SSE 服务进行调试。
•PyPI 地址:https://pypi.org/project/markitdown-mcp/
•项目来源:由微软 AutoGen 团队构建。
•GitHub:https://github.com/microsoft/markitdown/tree/main/packages/markitdown-mcp

6. 安全提示

• 该服务器没有内置身份验证机制。
• 它以运行它的用户的权限运行。
• 因此，在SSE 模式下运行时，强烈建议将其绑定到localhost(即127.0.0.1，这是默认行为)，避免暴露到不安全的网络中。

总结：

MarkItDown-MCP 是一个小而美的实用工具，它不仅简化了将各种内容转换为 Markdown 的过程，更重要的是通过MCP 协议打通了与 AI 模型（如 Claude）的连接，让 AI 能够更方便地利用外部信息。无论你是想提高内容处理效率，还是想为你的 AI Agent 添加新能力，MarkItDown-MCP 都值得一试！