/ Каталог / Песочница / ebook-mcp
● Сообщество onebirdrocks ⚡ Сразу

ebook-mcp

автор onebirdrocks · onebirdrocks/ebook-mcp

Point Claude at your EPUB and PDF library — get metadata, TOC, and chapter content in structured form so the model can quote and summarize precisely.

ebook-mcp wraps Python's common EPUB/PDF libs into MCP tools. Unlike generic 'read a file', it exposes table of contents and chapter boundaries, so Claude can fetch just the chapter you're asking about instead of dumping 500 pages into context.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

ebook.replay ▶ готово
0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "ebook": {
      "command": "uvx",
      "args": [
        "ebook-mcp"
      ],
      "_inferred": true
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "ebook": {
      "command": "uvx",
      "args": [
        "ebook-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "ebook": {
      "command": "uvx",
      "args": [
        "ebook-mcp"
      ],
      "_inferred": true
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "ebook": {
      "command": "uvx",
      "args": [
        "ebook-mcp"
      ],
      "_inferred": true
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "ebook",
      "command": "uvx",
      "args": [
        "ebook-mcp"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json
{
  "context_servers": {
    "ebook": {
      "command": {
        "path": "uvx",
        "args": [
          "ebook-mcp"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add ebook -- uvx ebook-mcp

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: ebook-mcp

Find and quote a passage you vaguely remember

👤 Readers / researchers ⏱ ~5 min beginner

Когда использовать: 'There was something in that book about X...' — you need the exact quote and can't be bothered to flip pages.

Предварительные требования
  • The book file on disk — EPUB or PDF
Поток
  1. Load TOC
    Show me the TOC of ~/Books/deep-work.epub. Which chapter likely discusses shallow work vs deep work?✓ Скопировано
    → TOC + best-guess chapter
  2. Pull the chapter
    Get the text of chapter 3. Find the passage about shallow-work-as-default.✓ Скопировано
    → Quoted passage

Итог: Quote in hand, citable, in 2 minutes.

Подводные камни
  • Scanned PDFs have no text layer — Run OCR first

Generate a chapter-by-chapter summary of a technical book

👤 Engineers learning from a book on their TBR ⏱ ~30 min intermediate

Когда использовать: You want to decide whether to actually read a book, or need a refresher after finishing.

Поток
  1. TOC first
    Load TOC of book.pdf. Show me chapter titles and approximate page ranges.✓ Скопировано
    → Outline
  2. Per-chapter summary
    For each chapter, load its content and produce a 3-bullet summary. Output as a single Markdown doc.✓ Скопировано
    → Complete book digest

Итог: A 1-2 page book digest you can share or revisit.

Подводные камни
  • Huge books blow the token budget if you load all chapters at once — Process one chapter at a time; write intermediate summaries to disk
Сочетать с: filesystem

Audit your ebook library's metadata

👤 Calibre users, ebook hoarders ⏱ ~15 min beginner

Когда использовать: Your library has 500 ebooks and you want to find ones with missing title/author metadata.

Поток
  1. Scan
    For each .epub under ~/Books, get metadata. List any where title or author is missing or contains 'Unknown'.✓ Скопировано
    → Incomplete-metadata list

Итог: Quick metadata hygiene pass.

Сочетать с: filesystem

Комбинации

Сочетайте с другими MCP — эффект x10

ebook + local-rag

Build a searchable library index

For each book, get_chapter by chapter, ingest into local-rag with book title as source.✓ Скопировано
ebook + notion

Auto-populate your reading journal

Take this just-finished book; summarize each chapter; create a Notion page in 'Books Read'.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
get_metadata path: str First pass on any book free
get_toc path: str Before pulling chapter content free
get_chapter path, chapter_id or id_range Load a specific chapter free
get_pages path, from_page, to_page (PDF only) Page-range extraction for PDFs free

Стоимость и лимиты

Во что обходится

Квота API
None
Токенов на вызов
Chapters 2k-30k tokens depending on length
Деньги
Free (Apache 2.0)
Совет
Always load TOC first. Then load chapters one at a time rather than the whole book.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: None — local files only
Исходящий трафик: Book content goes to your LLM provider

Устранение неполадок

Частые ошибки и исправления

Unable to parse PDF

Scanned/image-only PDF has no text layer. Run ocrmypdf first.

Проверить: pdftotext input.pdf - | head
EPUB chapter ID not found

IDs come from the TOC exactly. Call get_toc first.

Large PDF makes get_chapter timeout

Use get_pages with a smaller page range; batch.

Альтернативы

ebook-mcp в сравнении

АльтернативаКогда использоватьКомпромисс
Calibre + custom scriptYou want full Calibre integrationMore setup; no MCP wrapper
pdfplumber / pymupdf directlyYou build your own toolingBuild your own MCP wrapper

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills