Epub Mcp

What is Epub Mcp?

Epub Mcp is an MCP server that provides a set of tools for reading EPUB file contents. It is designed for use with MCP clients such as cline (formerly known as cline) and wraps the @lingo-reader/epub-parser library to expose EPUB reading capabilities as MCP tools.

How to use Epub Mcp?

Install and run using npx -y epub-mcp or execute directly with Node.js via <Installation Directory>/node_modules/epub-mcp/dist/index.mjs. Configure it under mcpServers in your MCP client (e.g., cline) using the command/args syntax. On Windows use cmd /c npx -y epub-mcp for compatibility.

Key features of Epub Mcp

• Initialize or reset an EPUB file (initEpubFile)
• Retrieve the collection list (getCollection)
• Get file information (getFileInfo)
• Obtain the manifest (getManifest)
• Read metadata (getMetadata)
• Navigate the nav list (getNavList)
• Get the page list (getPageList)
• Retrieve the spine (getSpine)
• Access the table of contents (getToc)
• Load a specific chapter (loadChapter)

Use cases of Epub Mcp

• Extract metadata (title, author, etc.) from EPUB files
• Browse the full table of contents of an ebook
• Load and display individual chapters programmatically
• Analyze the manifest and spine structure of an EPUB
• Build an AI‑powered reading assistant using MCP tools

FAQ from Epub Mcp

What dependencies does Epub Mcp require?

Epub Mcp requires Node.js and npx runtime. It internally uses the @lingo-reader/epub-parser library, which is bundled when installed via npm.

How do I configure Epub Mcp on Windows?

On Windows use the following JSON configuration: "command": "cmd" with "args": ["/c", "npx", "-y", "epub-mcp"] to ensure compatibility.

Does Epub Mcp modify EPUB files?

No. All tools are read‑only — they retrieve information but do not alter the EPUB file.

What tools does Epub Mcp provide?

Epub Mcp offers 10 tools: initEpubFile, getCollection, getFileInfo, getManifest, getMetadata, getNavList, getPageList, getSpine, getToc, and loadChapter. Detailed documentation is available in the linked library’s README.

Where can I find the detailed tool documentation?

The underlying API documentation for @lingo-reader/epub-parser is at https://github.com/hhk-png/lingo-reader/blob/main/packages/epub-parser/README-zh.md (Chinese).