Pdf2md MCP

🚀 PDF2MD MCP 服務器

PDF2MD MCP 服務器是一個基於模型上下文協議（MCP）的服務，藉助人工智能採樣能力，能夠將 PDF 文件高效轉換為 Markdown 格式，極大提升文檔處理效率。

✨ 主要特性

• 智能內容提取：利用人工智能技術精準提取 PDF 文件內容，並轉換為 Markdown 格式。
• 多源支持：既支持本地文件路徑，也支持通過 URL 訪問的遠程 PDF 文件轉換。
• 斷點續傳：支持增量轉換，可從上次中斷的位置繼續進行轉換。
• 靈活輸出：輸出目錄可自定義配置。
• 高性能運行：基於 FastMCP 構建，具備出色的性能表現。

📦 安裝指南

pip install pdf2md-mcp

💻 使用示例

基礎用法

啟動 MCP 服務器：

pdf2md-mcp

服務器啟動後，將提供用於 PDF 轉 Markdown 的 MCP 工具。

高級用法

convert_pdf_to_markdown

該工具使用人工智能採樣功能，將 PDF 文件轉換為 Markdown 格式。

參數說明：

• file_path（字符串）：PDF 文件的本地路徑或 URL。
• output_dir（字符串，可選）：Markdown 文件的輸出目錄。對於本地文件，默認與輸入文件在同一目錄；對於 URL 文件，默認是當前工作目錄。

返回值：

• output_file：生成的 Markdown 文件的路徑。
• summary：轉換任務的摘要。
• pages_processed：已處理的頁面數量。

📚 詳細文檔

運行要求

• Python 3.10 及以上版本。
• 具備人工智能採樣能力的 MCP 兼容客戶端。
• 若使用基於 URL 的 PDF 文件，需具備網絡訪問權限。

開發相關

環境搭建

git clone https://github.com/shuminghuang/pdf2md-mcp.git
cd pdf2md-mcp
pip install -e ".[dev]"

運行測試

pytest

代碼格式化

black .
isort .

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

🤝 貢獻說明

歡迎大家為項目貢獻力量！請隨時提交拉取請求。