MarkItDown MCP 服务端

一个使用 MarkItDown 工具将各种文件格式转换为 Markdown 的模型上下文协议（MCP）服务端。

支持的格式

• 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 命令：

• /md <file> - 将指定文件转换为 Markdown

示例：

/md document.pdf

支持的 MCP 客户端

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

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

许可证

MIT License。有关详细信息，请参阅 LICENSE。

致谢

https://github.com/microsoft/markitdown#readme