Ebook Server
FreeNot checkedProvides AI assistants with direct access to your ebook library, enabling listing books, reading chapters, and searching across books via the Model Context Prot
About
Provides AI assistants with direct access to your ebook library, enabling listing books, reading chapters, and searching across books via the Model Context Protocol.
README
An MCP (Model Context Protocol) server that provides AI assistants with direct access to your ebook library. Works with Claude, Cursor, and other MCP-compatible clients.
Features
- List books in your library with metadata (title, author, language)
- Read chapters individually or in ranges
- Search within books or across your entire library
- EPUB support with automatic text extraction
Why Use This Instead of LLM Training Data?
LLMs like Claude have read millions of books during training, but they don't actually have those books—they have a compressed neural representation of patterns and themes. This creates real limitations:
| Question Type | LLM Training Data | MCP Ebook Server |
|---|---|---|
| "What's the 10th word of chapter 2?" | ❌ Cannot answer | ✅ Exact answer |
| "Quote the opening paragraph" | ⚠️ Often paraphrased or hallucinated | ✅ Verbatim text |
| "How many times is 'magic' mentioned?" | ❌ Guesses | ✅ Precise count |
| "What happens in chapter 5?" | ⚠️ May confuse with similar books | ✅ Actual content |
| "Does this book mention X?" | ⚠️ Uncertain, may hallucinate | ✅ Searchable proof |
The core problem: LLMs retain the gist of books—major plot points, famous quotes, general themes—but lose precise details. When asked about specifics they don't know, they often hallucinate plausible-sounding answers rather than admitting uncertainty.
The solution: This MCP server gives AI direct access to the actual source text. Instead of guessing, the AI can read the exact chapter, search for specific terms, and cite real passages. No hallucinations, just the book.
Installation
Docker (Recommended)
docker run -p 8080:8080 -v /path/to/your/ebooks:/ebooks ghcr.io/bryanlabs/mcp-ebook-server:latest
Docker Compose
services:
mcp-ebook-server:
image: ghcr.io/bryanlabs/mcp-ebook-server:latest
ports:
- "8080:8080"
volumes:
- /path/to/your/ebooks:/ebooks:ro
pip
pip install git+https://github.com/bryanlabs/mcp-ebook-server.git
mcp-ebook-server --library-path /path/to/your/ebooks
From Source
git clone https://github.com/bryanlabs/mcp-ebook-server.git
cd mcp-ebook-server
pip install -e .
mcp-ebook-server
Configuration
| Variable | Default | Description |
|---|---|---|
EBOOK_LIBRARY_PATH |
/ebooks |
Path to your ebook directory |
MCP_HOST |
0.0.0.0 |
Host to bind the server |
MCP_PORT |
8080 |
Port for the SSE endpoint |
Usage
Once the server is running, connect your MCP client to http://localhost:8080/sse.
Available Tools
| Tool | Description | Example |
|---|---|---|
list_books() |
List all ebooks with metadata | "What books do I have?" |
get_book_info(book_path) |
Get book details and chapter list | "How many chapters in The Magicians?" |
get_chapter(book_path, chapter_number) |
Read a specific chapter | "Read chapter 1" |
get_chapters_range(book_path, start, end) |
Read multiple chapters | "Get chapters 1-3" |
search_book(book_path, query) |
Search within a book | "Find mentions of 'magic'" |
search_library(query) |
Search all books | "Search for 'dragon'" |
Supported Formats
| Format | Status |
|---|---|
| EPUB | Fully supported |
| MOBI | Requires conversion to EPUB |
| AZW3 | Requires conversion to EPUB |
| Not supported |
License
MIT License - see LICENSE for details.
Install Ebook Server in Claude Desktop, Claude Code & Cursor
unyly install mcp-ebook-serverInstalls into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.
First time? Get the CLI: curl -fsSL https://unyly.org/install | sh
Or configure manually
Run in your terminal:
claude mcp add mcp-ebook-server -- uvx --from git+https://github.com/bryanlabs/mcp-ebook-server mcp-ebook-serverFAQ
Is Ebook Server MCP free?
Yes, Ebook Server MCP is free — one-click install via Unyly at no cost.
Does Ebook Server need an API key?
No, Ebook Server runs without API keys or environment variables.
Is Ebook Server hosted or self-hosted?
A hosted option is available: Unyly runs the server in the cloud, no local setup required.
How do I install Ebook Server in Claude Desktop, Claude Code or Cursor?
Open Ebook Server on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Fetch
Web content fetching and conversion for efficient LLM usage.
AWS KB Retrieval
Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
by modelcontextprotocolSpring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
llm-analysis-assistant
A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also
by xuzexin-hzCompare Ebook Server with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All ai MCPs
