🚀 电子书内容处理平台（ebook - MCP）

这是一个专门用于处理和分析电子书文件的工具平台，支持EPUB和PDF两种常见格式。它能提取元数据、获取目录结构、读取章节内容，还可将内容转换为Markdown格式。此外，该平台提供了一个可通过命令运行的服务端框架，为用户带来便利。

🚀 快速开始

本平台可帮助你轻松处理和分析EPUB与PDF格式的电子书文件，提供丰富功能，如提取元数据、获取目录结构等。

✨ 主要特性

EPUB处理功能

• 能够获取指定目录下的所有EPUB文件。
• 可提取EPUB文件的元数据信息，像标题、作者、出版日期等。
• 可以读取EPUB文件的目录结构。
• 能获取特定章节的内容并将其转换为Markdown格式。

PDF处理功能

• 可以获取指定目录下的所有PDF文件。
• 能提取PDF文件的元数据信息。
• 可读取PDF文件的目录结构。
• 能获取特定页码的内容，支持纯文本和Markdown格式。
• 可根据章节标题获取对应内容及其所在的页码范围。

📦 安装指南

关键依赖

• 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")

📚 详细文档

API参考

EPUB APIs

PDF APIs