Epub Mcp

@hhk-png

About Epub Mcp

mcp about load content from epub file

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "epub-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "epub-mcp"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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).

Frequently asked questions

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).