markdownify-mcp

项目概述

Markdownify MCP Server 是由 Zach Caceres（GitHub：zcaceres）开发的一个 Model Context Protocol (MCP) 服务器，旨在将各种文件类型和网页内容转换为 Markdown 格式。

• 主要用途：为 AI agent 或桌面工具提供统一的 Markdown 转换服务。
• 支持环境：基于 TypeScript + Node.js，配合 Python 工具组件运行。

核心功能 / 特性

✅ 多种文件格式转换为 Markdown

完整工具列表如下（标自 README）：

• pdf-to-markdown
• docx-to-markdown
• xlsx-to-markdown
• pptx-to-markdown
• image-to-markdown
• audio-to-markdown
• webpage-to-markdown
• youtube-to-markdown
• bing-search-to-markdown
• get-markdown-file：允许检索已有的 .md 或 .markdown 文件

🔧 环境配置与使用方式

1. 克隆仓库
2. 安装依赖：pnpm install（并会安装 uv/python 依赖）
3. 构建：pnpm run build
4. 启动服务：pnpm start

可通过 pnpm run dev 启动 TS watch 模式并修改 src/server.ts 或 src/tools.ts 自定义行为。
也可将其集成进桌面客户端（如 Cursor），在配置 JSON 中声明该 MCP 服务即可

⚙️ 可选配置

• 支持通过环境变量 MD_SHARE_DIR 限制允许读取 Markdown 文件的目录，提高访问控制 ([github.com][1])。

总结建议

• 优点

  • 支持丰富文件类型，功能全面
  • 集成方便，可组合部署
  • 社区活跃，文档详尽，易上手

• 不足 / 注意事项

  • 当前存在中等安全风险，建议仅在安全隔离环境使用，或等待正式修补
  • Windows 支持尚待加强（项目作者希望有人协助测试 Windows PR）

• 适用场景

  • AI 助手、自动化脚本需要统一 Markdown 输入输出时
  • 内容抓取、文档归档、研究资料整理等场景中
  • 希望快速集成多格式转 Markdown 服务的 Web 或桌面项目