JinDaGe - markitdown_mcp_server MCP Details

article

README

🚀 MarkItDown MCP Server

MarkItDown MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器，借助 MarkItDown 工具，它能将多种文件格式转换为 Markdown，为文件处理带来极大便利。

🚀 快速开始

MarkItDown MCP Server 能将多种文件格式转换为 Markdown，以下将介绍其支持的文件格式、安装方式、使用方法等内容。

✨ 主要特性

多格式支持：支持 PDF、PowerPoint、Word、Excel、图像、音频、HTML、基于文本的格式（如 CSV、JSON、XML）以及 ZIP 文件等多种格式。
MCP 兼容性：可与任何 MCP 客户端集成，为不同工具提供文件转换服务。

📦 安装指南

通过 Smithery 安装

若要通过 Smithery 自动为 Claude Desktop 安装 MarkItDown MCP Server，可使用以下命令：

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

手动安装

克隆此仓库。
安装依赖：

uv install

💻 使用示例

作为 MCP 服务器使用

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

Zed Editor

在 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 客户端

MarkItDown MCP Server 可与 modelcontextprotocol.io/clients 列出的任何符合 MCP 标准的客户端配合使用，包括：

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

📄 许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE。

👏 致谢

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

markitdown_mcp_server