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 或桌面專案