Markdownify MCP 服务器

Markdownify 是一个模型上下文协议（MCP）服务器，能够将多种文件类型和网络内容转换为 Markdown 格式。它提供了一系列工具，用于将 PDF、图像、音频文件、网页等内容转换成易于阅读和分享的 Markdown 文本。

特性

• 将多种文件类型转换为 Markdown：
  • PDF
  • 图像
  • 带转录的音频
  • DOCX
  • XLSX
  • PPTX
• 将网络内容转换为 Markdown：
  • YouTube 视频字幕
  • Bing 搜索结果
  • 通用网页
• 获取现有 Markdown 文件

入门指南

1. 克隆此仓库
2. 安装依赖项：

   pnpm install
   

注意：这也将安装 uv 及相关 Python 依赖项。

3. 构建项目：

   pnpm run build
   

4. 启动服务器：

   pnpm start
   

开发

• 使用 pnpm run dev 以启动 TypeScript 编译器的监视模式
• 修改 src/server.ts 以自定义服务器行为
• 在 src/tools.ts 中添加或修改工具

与桌面应用集成使用

要将此服务器与桌面应用集成，请在应用的服务器配置中添加以下内容：

{
  "mcpServers": {
    "markdownify": {
      "command": "node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ],
      "env": {
        // 默认情况下，服务器将使用 `uv` 的默认安装位置
        "UV_PATH": "/path/to/uv"
      }
    }
  }
}

可用工具

• youtube-to-markdown：将 YouTube 视频转换为 Markdown
• pdf-to-markdown：将 PDF 文件转换为 Markdown
• bing-search-to-markdown：将 Bing 搜索结果转换为 Markdown
• webpage-to-markdown：将网页内容转换为 Markdown
• image-to-markdown：将图像转换为 Markdown 并附带元数据
• audio-to-markdown：将音频文件转换为 Markdown 并附带转录文本
• docx-to-markdown：将 DOCX 文件转换为 Markdown
• xlsx-to-markdown：将 XLSX 文件转换为 Markdown
• pptx-to-markdown：将 PPTX 文件转换为 Markdown
• get-markdown-file：获取现有 Markdown 文件

贡献

欢迎贡献！请随意提交 Pull Request。

许可证

此项目 licensed under MIT License - 有关详细信息，请参阅 LICENSE 文件。