文件转Markdown服务

一个基于Model Context Protocol (MCP)的服务器,使用MarkItDown工具将多种文件格式转换为Markdown格式。

  • by tevinric
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 tevinric/mcp_bridge

使用说明

MarkItDown MCP 服务器

一个模型上下文协议(MCP)服务器,使用MarkItDown工具将各种文件格式转换为Markdown格式。

支持的格式

  • PDF(Portable Document Format,便携式文档格式)
  • PowerPoint(演示文稿软件)
  • Word(文字)
  • Excel
  • 图像(EXIF元数据和OCR)
  • 音频(EXIF元数据和语音转录)
  • HTML(超文本标记语言)
  • 基于文本的格式(CSV、JSON、XML)
  • ZIP 文件(遍历其中的内容)

安装

通过Smithery进行安装

通过自动方式为Claude Desktop安装MarkItDown MCP服务器 “Smithery”可以翻译为“铁匠铺”或“锻造工坊”。这个词汇源自对铁匠或锻造工艺的描述,通常指的是一个进行金属加工、锻造或修理等工作的场所:

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

与任何符合MCP标准的客户端兼容,这些客户端均列于 modelcontextprotocol.io/clients 翻译为中文是:“模型上下文协议.io/客户端”,包括:

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

许可证

麻省理工学院许可证。参见 许可证 详情请见。

致谢

https://github.com/microsoft/markitdown#readme 的中文翻译可以是:“https://github.com/microsoft/markitdown 项目说明(README)文件” 或者简化为 “微软 markitdown 项目 README 链接”。不过,通常在中文语境下,我们可能会直接说“微软的 markitdown 项目在 GitHub 上的 README 文件链接”,以更自然地表达这个意思