MarkItDown MCP Server

Name: MarkItDown MCP Server
Author: KorigamiK

本地服务

github.com/KorigamiK生产力8844 周前更新

代码仓库

关于 MarkItDown MCP Server

MarkItDown MCP Server 是一个 MCP 服务，借助 MarkItDown 工具将 PDF、Office 文档、图片、音频、HTML 等多种文件转换为 Markdown。适合需要把文档内容交给 AI 模型处理的用户。

主要功能

01支持 PDF、Word、PowerPoint、Excel 转换
02图片 OCR 与音频语音转录
03HTML 与 CSV、JSON、XML 等文本格式转换
04ZIP 文件内容逐一转换

适用场景

01将 PDF 或 Office 文档转为 Markdown 供模型阅读
02在 Zed 编辑器中通过 /md 命令转换文件

MCP 相关

这是一个 MCP 服务，向 MCP 客户端提供 /md 命令，用于将指定文件转换为 Markdown。

#python #mcp #mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "markitdown_mcp_server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}

启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@smithery/clistdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

MarkItDown MCP 服务

一个 Model Context Protocol（MCP）服务，使用 MarkItDown 工具将各种文件格式转换为 Markdown。

支持的格式

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

安装

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

命令

此服务会响应以下 MCP 命令：

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

示例：

/md document.pdf

支持的 MCP 客户端

可与 modelcontextprotocol.io/clients 中列出的任何兼容 MCP 的客户端配合使用，包括：

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

许可证

MIT 许可证。详情请参阅 LICENSE。

致谢

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

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。