Back to MCP directory
publicPublicdnsLocal runtime

markitdown_mcp_server

一个通过MarkItDown工具将多种文件格式转换为Markdown的MCP服务

article

README

🚀 MarkItDown MCP 服务器

MarkItDown MCP 服务器是一个强大的工具,它借助 MarkItDown 工具,能够将多种文件格式转换为 Markdown,为用户处理不同格式文件提供了便利。

smithery 徽章

🚀 快速开始

MarkItDown MCP 服务器可轻松将各类文件转换为 Markdown 格式,下面将为你介绍其安装和使用方法。

✨ 主要特性

  • 多格式支持:支持 PDF、PowerPoint、Word、Excel、图像、音频、HTML、文本格式(CSV、JSON、XML)以及 ZIP 文件等多种格式的转换。
  • 广泛兼容性:与任何符合 MCP 标准的客户端兼容,如 Zed 编辑器等。

📦 安装指南

通过 Smithery 安装

要通过 Smithery 自动安装 MarkItDown MCP Server for Claude Desktop,可执行以下命令:

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

📚 详细文档

支持的 MCP 客户端

MarkItDown MCP 服务器与任何符合 MCP 标准的客户端兼容,包括 Zed 编辑器以及其他 MCP 兼容的编辑器和工具。

📄 许可证

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

致谢

感谢 https://github.com/microsoft/markitdown#readme 提供的相关支持。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client