Ebook MCP

🚀 電子書籍コンテンツ処理プラットフォーム（ebook - MCP）

このプラットフォームは、電子書籍ファイルの処理と分析を行うツールです。EPUBとPDF形式のファイルをサポートし、メタデータの抽出、目次構造の取得、章の内容の読み取りなどの機能を提供し、コンテンツをMarkdown形式に変換することができます。また、コマンドで実行できるサーバーサイドフレームワークも提供しています。

🚀 クイックスタート

✨ 主な機能

EPUB処理機能

1. 指定したディレクトリ内のすべてのEPUBファイルを取得します。
2. EPUBファイルのメタデータ情報（タイトル、著者、出版日など）を抽出します。
3. EPUBファイルの目次構造を読み取ります。
4. 特定の章の内容を取得し、Markdown形式に変換します。

PDF処理機能

1. 指定したディレクトリ内のすべてのPDFファイルを取得します。
2. PDFファイルのメタデータ情報を抽出します。
3. PDFファイルの目次構造を読み取ります。
4. 特定のページの内容を取得します（純テキストとMarkdown形式をサポート）。
5. 章のタイトルに基づいて対応する内容とそのページ番号範囲を取得します。

📦 インストール

主要な依存関係

• ebooklib：EPUBファイルを処理するためのライブラリ
• PyPDF2：基本的なPDF処理ライブラリ
• PyMuPDF：高度なPDF処理ライブラリ
• beautifulsoup4：HTML解析ツール
• html2text：HTMLをMarkdown形式に変換するツール
• pydantic：データ検証フレームワーク
• fastmcp：MCPサーバーサイドフレームワーク

💻 使用例

基本的な使用法

EPUB処理の例

# 指定したディレクトリ内のすべてのEPUBファイルを取得
epub_files = get_all_epub_files("/path/to/books")

# 単一のEPUBファイルのメタデータを抽出
metadata = get_metadata("/path/to/book.epub")

# EPUBファイルの目次構造を読み取り
toc = get_toc("/path/to/book.epub")

# 特定の章の内容を取得（Markdown形式）
chapter_content = get_chapter_markdown("/path/to/book.epub", "chapter_id")

PDF処理の例

# 指定したディレクトリ内のすべてのPDFファイルを取得
pdf_files = get_all_pdf_files("/path/to/books")

# 単一のPDFファイルのメタデータを抽出
metadata = get_pdf_metadata("/path/to/book.pdf")

# PDFファイルの目次構造を読み取り
toc = get_pdf_toc("/path/to/book.pdf")

# 特定のページの内容を取得（純テキスト形式）
page_text = get_pdf_page_text("/path/to/book.pdf", 1)

# 特定のページの内容を取得（Markdown形式）
page_markdown = get_pdf_page_markdown("/path/to/book.pdf", 1)

# 章のタイトルに基づいて対応する内容とそのページ番号範囲を取得
chapter_content, page_numbers = get_pdf_chapter_content("/path/to/book.pdf", "Chapter 1")

📚 ドキュメント

EPUB API

get_all_epub_files(path: str) -> List[str]

指定したディレクトリ内のすべてのEPUBファイルのパスを取得します。

get_metadata(epub_path: str) -> Dict[str, Union[str, List[str]]]

指定したEPUBファイルのメタデータ情報を抽出します。

get_toc(epub_path: str) -> List[Tuple[str, str]]

指定したEPUBファイルの目次構造を取得し、章のタイトルとそれに対応するIDを返します。

get_chapter_markdown(epub_path: str, chapter_id: str) -> str

章のIDに基づいて対応する章の内容を取得し、Markdown形式に変換します。

PDF API

get_all_pdf_files(path: str) -> List[str]

指定したディレクトリ内のすべてのPDFファイルのパスを取得します。

get_pdf_metadata(pdf_path: str) -> Dict[str, Union[str, List[str]]]

指定したPDFファイルのメタデータ情報を抽出します。

get_pdf_toc(pdf_path: str) -> List[Tuple[str, int]]

指定したPDFファイルの目次構造を取得し、章のタイトルとそれに対応するページ番号を返します。

get_pdf_page_text(pdf_path: str, page_number: int) -> str

指定したページ番号に対応する内容を取得します（純テキスト形式）。

get_pdf_page_markdown(pdf_path: str, page_number: int) -> str

指定したページ番号に対応する内容を取得します（Markdown形式）。

get_pdf_chapter_content(pdf_path: str, chapter_title: str) -> Tuple[str, List[int]]

章のタイトルに基づいて対応する内容とそのページ番号範囲を取得します。