📚 KCC CBZ-to-Kindle EPUB MCP Server

An advanced Model Context Protocol (MCP) server built on top of Kindle Comic Converter (KCC) and PyTorch CUDA GPU acceleration.

Specifically designed to handle large comic archives (.cbz, .cbr, zip files up to 1GB+) and convert them into Kindle-optimized EPUB volumes cleanly partitioned under the ~200MB limit for Amazon's Send to Kindle service.

✨ Features

• ⚡ GPU VRAM Acceleration: Leverages PyTorch CUDA for batch image scaling, grayscale conversion, and gamma processing directly in VRAM.

• 📦 Send-to-Kindle Smart Chunking: Automatically partitions 1GB+ multi-volume comics into ~190MB EPUB chunks to guarantee compliance with Amazon's 200MB upload limit.

• 📱 Multi-Device Target Profiles: Custom E-ink display optimization for:

  • Kindle Paperwhite 5 (KPW5 — 1236×1648)

  • Kindle Scribe (KS — 1860×2480)

  • Kindle Oasis (KO — 1264×1680)

  • Kindle Paperwhite 3/4 (KPW34 — 1072×1448)

  • Kindle Voyage / 11 (KV / K11 — 1072×1448)

• 📖 Manga & Comic Support: Full support for Right-to-Left (RTL Manga) and Left-to-Right (LTR Western Comics) reading styles.

• 🔍 Archive Inspector: Inspect total pages, uncompressed sizes, and estimated volume chunks before converting.

Related MCP server: Calibre RAG MCP Server

🛠️ Provided MCP Tools

⚙️ Requirements & Installation

System Prerequisites

• Python 3.10+

• KindleComicConverter (kcc-c2e) CLI binary

• NVIDIA GPU with CUDA drivers (Optional, for GPU acceleration)

Installation

# 1. Clone Repository
git clone https://github.com/AmitKumarMyT/kcc-epub-converter-mcp.git
cd kcc-epub-converter-mcp

# 2. Install Dependencies
pip install -r requirements.txt

🔌 Integrating with MCP Clients

Add the server entry to your MCP client configuration (mcp_config.json for Claude Desktop, Gemini Antigravity, or VS Code MCP Extension):

{
  "mcpServers": {
    "kcc-epub-converter": {
      "command": "python3",
      "args": [
        "/absolute/path/to/kcc-epub-converter-mcp/mcp_server.py"
      ],
      "env": {
        "PATH": "/home/myt/.local/bin:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

📜 License

This project is licensed under the terms specified in the LICENSE file.