Korigamik Markitdown MCP Server

🚀 MarkItDown MCP 服务端

MarkItDown MCP 服务端是一个强大的工具，它借助 MarkItDown 工具，能够将多种文件格式转换为 Markdown 格式，为用户提供便捷的文件处理体验。

🚀 快速开始

MarkItDown MCP 服务端可将多种文件格式转换为 Markdown，下面为你介绍它的安装和使用方法。

✨ 主要特性

• 多格式支持：支持 PDF、PowerPoint、Word、Excel 等多种常见文件格式，甚至包括图像、音频、HTML、文本格式以及 ZIP 文件。
• 广泛兼容性：可与任何符合 MCP 标准的客户端集成，如 Zed 编辑器等。

📦 安装指南

通过 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"
      ]
    }
  }
}

高级用法

命令

服务端支持 /md <file> 命令，用于将指定文件转换为 Markdown。示例如下：

/md document.pdf

📚 详细文档

支持的格式

• PDF
• PowerPoint
• Word
• Excel
• 图像（EXIF 元数据和 OCR）
• 音频（EXIF 元数据和语音转录）
• HTML
• 文本格式（CSV、JSON、XML）
• ZIP 文件（遍历内容）

支持的 MCP 客户端

与 modelcontextprotocol.io/clients 列表中任何符合 MCP 标准的客户端兼容，包括：

• Zed 编辑器
• 任何其他与 MCP 兼容的编辑器和工具

📄 许可证

本项目采用 MIT License。有关详细信息，请参阅 LICENSE。

致谢

参考文档：https://github.com/microsoft/markitdown#readme