MCP Server PDF Conversion

🚀 電子書籍MCPサーバー（PDF変換機能付き）

このプロジェクトは、埋め込み画像を含むHTMLコンテンツから電子書籍やPDFファイルを作成するサーバーです。HTMLファイルをPDFに変換する強力な機能を備え、埋め込み画像も適切に処理します。

✨ 主な機能

• HTMLファイルをPDF文書に変換し、埋め込み画像を正しく処理する
• pdfkit（wkhtmltopdf）とreportlabの2種類のPDF生成エンジンをサポートする
• 堅牢なエラー処理とログ記録機能を持つ
• 一時ファイルを自動管理し、クリーンアップ機構を備える
• 変換過程で詳細な診断情報を提供する

📦 インストール

プロジェクト要件

• Python 3.9以上
• wkhtmltopdf（オプションだが、より良いPDF品質を得るために推奨）
• Python依存パッケージ：
  • fastapi
  • python-docx
  • pdfkit
  • reportlab
  • pydantic
  • uvicorn
  • pillow

インストール手順

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

💻 使用例

基本的な使用法

サーバーは 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：プロジェクトのメタデータと依存関係