About Epub Mcp
Epub Mcp is an MCP server for reading EPUB file contents. It exposes file, metadata, navigation, table-of-contents, and chapter-loading operations through tools that call `@lingo-reader/epub-parser`.
Key features
- 01Initialize an EPUB file
- 02Retrieve file information and metadata
- 03Read manifest and navigation data
- 04Get page list, spine, and table of contents
- 05Load a chapter
Use cases
- 01Inspect an EPUB's metadata
- 02Browse an EPUB's navigation and contents
- 03Load chapters from an EPUB
MCP support
The MCP server exposes tools for initializing and reading EPUB files, including chapter loading. These tools call the API of `@lingo-reader/epub-parser`.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
9Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| filePath | string | Yes |
Details
From the project READMEThis project is an MCP related to EPUB files, providing an MCP tool for reading EPUB file contents.
Usage
the mcpServers configuration of cline:
{
"mcpServers": {
"epub-mcp": {
"command": "npx",
"args": [
"-y",
"epub-mcp"
]
}
}
}
In windows env, we can use the following configuration:
{
"mcpServers": {
"epub-mcp": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"epub-mcp"
]
}
}
}
But the most reliable configuration is to use node to execute the corresponding file directly:
{
"mcpServers": {
"epub-mcp": {
"command": "node",
"args": [
// the install path of `epub-mcp`
"<Installation Directory>\\node_modules\\epub-mcp\\dist\\index.mjs"
]
}
}
}
Tools
reset or init epub（initEpubFile）
Parameters：
filePath: The absolute path of the file in the file system.
Returns：
- void
get collection-（getCollection）
get file info-（getFileInfo）
get manifest-（getManifest）
get metadata-（getMetadata）
get nav list-（getNavList）
get page list-（getPageList）
get spine-（getSpine）
get table of contents-（getToc）
load chapter-（loadChapter）
Parameters：
- none
For detailed explanation of the above tools, please refer to: https://github.com/hhk-png/lingo-reader/blob/main/packages/epub-parser/README-zh.md. This MCP simply calls the api of @lingo-reader/epub-parser.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.