epub-mcp logo

epub-mcp

by hhk-png

This project is an MCP (Message Communication Protocol) tool specifically designed for reading EPUB file contents. It provides a way to interact with and extract information from EPUB files.

View on GitHub

Last updated: N/A

What is epub-mcp?

epub-mcp is an MCP server that allows you to programmatically access and extract data from EPUB files. It acts as a bridge between your application and the EPUB file format, providing a set of tools to retrieve various components of the EPUB.

How to use epub-mcp?

To use epub-mcp, you need to configure it as an MCP server within a compatible environment like cline. The configuration involves specifying the command to execute the server, along with any necessary arguments. The provided examples demonstrate configurations for different environments, including Windows and direct Node.js execution.

Key features of epub-mcp

  • reset or init epub (initEpubFile)

  • get collection

  • get file info

  • get manifest

  • get metadata

  • get nav list

  • get page list

  • get spine

  • get table of contents

  • load chapter

Use cases of epub-mcp

  • Building ebook readers or library management systems

  • Extracting metadata from EPUB files for indexing or cataloging

  • Programmatically accessing and manipulating EPUB content

  • Integrating EPUB parsing capabilities into other applications

FAQ from epub-mcp

What is MCP?

MCP stands for Message Communication Protocol. In this context, it refers to a standardized way for applications to communicate with the epub-mcp server.

Where can I find more detailed documentation for the tools?

Refer to the lingo-reader project's epub-parser documentation for detailed explanations of the available tools: [https://github.com/hhk-png/lingo-reader/blob/main/packages/epub-parser/README-zh.md]

What is the purpose of the initEpubFile tool?

The initEpubFile tool is used to reset or initialize an EPUB file, likely preparing it for further processing.

What kind of information can I retrieve using this MCP?

You can retrieve various components of an EPUB file, including metadata, manifest, table of contents, spine, navigation list, and individual chapters.

Do I need to install any dependencies to use this?

Yes, you will need to have Node.js and npm (or a similar package manager) installed to run the server. You'll also need to install the epub-mcp package itself.