MCP Server PDF Conversion

🚀 電子書MCP服務器帶PDF轉換功能

本項目是一個服務器項目，可從包含嵌入式圖片的HTML內容創建電子書和PDF文件。它具備強大的HTML轉PDF功能，還能妥善處理嵌入式圖片，為用戶提供便捷的文檔轉換服務。

🚀 快速開始

本項目可將包含嵌入式圖片的HTML內容轉換為電子書和PDF文件。你可以按照以下步驟進行操作：

1. 克隆此倉庫。
2. 安裝所需的Python包：

pip install fastapi python-docx pdfkit reportlab pydantic uvicorn pillow

3. 安裝wkhtmltopdf（可選）：
   • Windows：從wkhtmltopdf.org下載並安裝。
   • Linux：sudo apt-get install wkhtmltopdf。
   • macOS：brew install wkhtmltopdf。

✨ 主要特性

• 圖片處理：將HTML文件轉換為PDF文檔並正確處理嵌入圖片。
• 雙引擎支持：支持pdfkit（wkhtmltopdf）和reportlab兩種PDF生成引擎。
• 健壯性：具備健壯的錯誤處理和日誌記錄功能。
• 臨時文件管理：自動管理臨時文件並帶有清理機制。
• 診斷信息：轉換過程中提供詳細的診斷信息。

📦 安裝指南

克隆倉庫

克隆此項目倉庫到本地。

安裝Python依賴

pip install fastapi python-docx pdfkit reportlab pydantic uvicorn pillow

安裝wkhtmltopdf（可選）

• Windows：從wkhtmltopdf.org下載並安裝。
• Linux：執行命令 sudo apt-get install wkhtmltopdf。
• macOS：執行命令 brew install wkhtmltopdf。

💻 使用示例

基礎用法

服務器提供了一個名為 handle_call_tool 的函數，接受以下參數：

arguments = {
  "text_file": "輸入文件路徑/to/input.html",
  "images": {
    "image1.png": "圖片路徑path/to/image1.png",
    "image2.jpg": "圖片路徑path/to/image2.jpg"
  },
  "output_pdf": "輸出PDF路徑path/to/output.pdf"
}

高級用法

以下是一個具體的調用示例：

result = await handle_call_tool("CREATE_DOC", {
    "text_file": "document.html",
    "images": {
        "header.png": "images/header.png",
        "footer.jpg": "images/footer.jpg"
    },
    "output_pdf": "output/document.pdf"
})

📚 詳細文檔

工作原理

1. 服務器處理輸入的HTML文件。
2. 將HTML中的圖片引用替換為絕對路徑。
3. 使用pdfkit（如果可用）嘗試將HTML轉換為PDF。
4. 如果pdfkit失敗或不可用，則回退到使用reportlab。
5. 將生成的PDF保存到指定的輸出路徑。

項目結構

• main.py：包含PDF轉換的核心功能。
• pyproject.toml：項目元數據和依賴項。

🔧 技術細節

項目要求

• Python 3.9+
• wkhtmltopdf（可選但推薦，以獲得更好的PDF質量）
• Python依賴項：
  • fastapi
  • python-docx
  • pdfkit
  • reportlab
  • pydantic
  • uvicorn
  • pillow