返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端