Markitdown

🚀 MarkItDown MCP 服务端

一个使用 MarkItDown 工具将多种文件格式转换为 Markdown 的模型上下文协议（MCP）服务端，为文件格式转换提供便捷方案。

🚀 快速开始

MarkItDown MCP 服务端可将多种文件格式转换为 Markdown，以下是详细介绍。

✨ 主要特性

• 支持多格式转换：支持 PDF、PowerPoint、Word、Excel、图片（含 EXIF 元数据和 OCR）、音频（含 EXIF 元数据和语音转录）、HTML、文本格式（CSV、JSON、XML）以及 ZIP 文件（遍历内容）的转换。

📦 安装指南

通过 Smithery 安装

要通过 Smithery 自动安装 MarkItDown MCP 服务端以用于 Claude 桌面版，可执行以下命令：

npx -y @smithery/cli install @KorigamiK/markitdown_mcp_server --client claude

手动安装

1. 克隆此仓库。
2. 安装依赖项：

uv install

💻 使用示例

作为 MCP 服务端

该服务端可以与任何 MCP 客户端集成。以下是一些示例：

基础用法

Zed 编辑器

在你的 settings.json 中添加以下内容：

"context_servers": {
  "markitdown_mcp": {
    "settings": {},
    "command": {
      "path": "uv",
      "args": [
        "--directory",
        "/path/to/markitdown_mcp_server",
        "run",
        "markitdown"
      ]
    }
  }
}

支持的 MCP 客户端

与任何符合 MCP 标准的客户端一起使用，包括：

• Zed 编辑器
• 其他任何 MCP 兼容的编辑器和工具，详见 modelcontextprotocol.io/clients

📄 许可证

本项目采用 MIT 许可证。详细信息请参阅 LICENSE。

致谢

参考项目：https://github.com/microsoft/markitdown#readme