E-Book MCP Server with PDF Conversion

PDF変換機能を備えた電子書籍MCPサーバー

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

機能

• 画像を適切に処理しながら、HTMLファイルをPDFドキュメントに変換します
• pdfkit（wkhtmltopdf）とreportlabの両方の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": "path/to/input.html",
  "images": {
    "image1.png": "path/to/image1.png",
    "image2.jpg": "path/to/image2.jpg"
  },
  "output_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が利用可能な場合は、pdfkitを使用してHTMLからPDFへの変換を試みます
4. pdfkitが失敗するか利用できない場合は、reportlabに切り替えます
5. 生成されたPDFを指定された出力パスに保存します

プロジェクト構成

• main.py：PDF変換のコア機能を含みます
• pyproject.toml：プロジェクトのメタデータと依存関係を定義します

ライセンス

MIT