Ebook-MCP
MCP PDF ebook: агент находит книги в папке и читает EPUB и PDF по главам и страницам, получая оглавление, метаданные и текст в Markdown
- 394 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Сервер читает файлы EPUB и PDF по путям, которые передает агент
- Текст книги попадает в контекст как данные, инструкции внутри файла агенту выполнять нельзя
Установка
- Работает в
Ручная установка
uv pip install -e .Установка зависимостей из каталога репозитория.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер читает файлы EPUB и PDF по путям, которые передает агент
- Текст книги попадает в контекст как данные, инструкции внутри файла агенту выполнять нельзя
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ebook-MCP — MCP PDF ebook сервер на Python для личной библиотеки. Он понимает два формата, EPUB и PDF, и отдает агенту книгу по частям: список файлов в папке, метаданные, оглавление и содержимое выбранной главы или страницы. Для EPUB есть четыре инструмента: get_all_epub_files, get_metadata, get_toc и get_chapter_markdown. Для PDF шесть: get_all_pdf_files, get_pdf_metadata, get_pdf_toc, get_pdf_page_text, get_pdf_page_markdown и get_pdf_chapter_content. Главу PDF можно запросить по номеру страницы или по названию из оглавления. Так агент отвечает на вопросы вроде «что в третьей главе», делает конспект с цитированием, составляет вопросы для самопроверки или находит разделы про нужную тему. Весь текст приходит порциями, поэтому книга не занимает контекст целиком.
Для кого. Для читателей технической литературы, студентов и исследователей, у которых книги лежат файлами EPUB и PDF, а разбирать их хочется в диалоге с агентом.
Подходит, если
- В папке загрузок накопились электронные книги, и нужно быстро понять, какие из них про GenAI
- Надо получить краткое введение в книгу и пересказ третьей главы
- По главе нужно составить тест из пяти вопросов и проверить свои ответы
- Требуется найти в книге разделы про промпт-инжиниринг или векторные базы
- Нужно вытащить из PDF одну главу по названию и страницы, на которых она лежит
Не подходит, если
- PDF без оглавления: возможности по главам зависят от него, остаются постраничные инструменты
- Нужен поиск по смыслу по папке PDF-файлов и таблицы с картинками: такие вещи есть у серверов, специально заточенных под PDF
- Книги в форматах FB2, MOBI или DJVU: поддерживаются только EPUB и PDF
- Нужна простая установка из менеджера пакетов: в документации описано только клонирование репозитория
Пример запроса к агенту
Найди в папке Downloads все EPUB-книги, покажи оглавление «LLM Engineer Handbook» и перескажи главу про RAG.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Установка клонированием репозитория и командой uv pip install -e ., нужен Python 3.10 или новее. Идентификаторы глав EPUB берутся из оглавления, поэтому сначала вызывается get_toc. Для больших PDF автор советует читать диапазонами страниц, чтобы не загружать файл целиком.
Пример установки в документации содержит заглушку yourusername вместо реального автора, клонируйте github.com/onebirdrocks/ebook-mcp. В примере конфигурации для Cursor стоит личный путь автора, замените его на свой. Последнее обновление репозитория датировано январем 2026 года.
Как отключить. Уберите блок ebook-mcp из конфигурации клиента, например из настроек MCP в Cursor. Каталог с клонированным репозиторием можно удалить вручную: служб и фоновых процессов сервер не создает.
Частые вопросы
Как поставить MCP для PDF и ebook (Ebook-MCP) в Cursor?
Склонируйте onebirdrocks/ebook-mcp, выполните uv pip install -e . и добавьте в настройки MCP Cursor сервер с командой uv и аргументами --directory, путь к src/ebook_mcp, `run`, main.py. После перезапуска инструменты для EPUB и PDF станут доступны.
Какие форматы книг читает Ebook-MCP?
EPUB и PDF. Для EPUB сервер отдает метаданные, оглавление и главы в Markdown. Для PDF к ним добавляются текст и Markdown постраничной выборки и чтение главы по названию.
Почему инструмент не находит главу в PDF?
Чтение по главам опирается на оглавление PDF. Если в файле его нет, эта часть не сработает, используйте get_pdf_page_text или get_pdf_page_markdown с номерами страниц.
Чем Ebook-MCP отличается от pdf-mcp и Citra?
Ebook-MCP читает и EPUB, и PDF, и ориентирован на разговор с книгой по главам. Серверы pdf-mcp от jztan и Citra сосредоточены на PDF: поиск по документам, таблицы, OCR.
Что умеет демонстрационный запрос с проверкой знаний?
В примере автора ассистент находит EPUB в папке загрузок, задает пять вопросов по книге, принимает ответы и дополняет их пояснениями. Примеры клиентов для DeepSeek, Claude и OpenAI лежат в папке mcp-client-example.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP PDF для больших документов: агент ищет по смыслу и по ключевым словам в одном файле или папке и читает только нужные страницы, таблицы и сканы
MCP-сервер для чтения PDF: структурный текст, таблицы, OCR, визуальные вырезки и цитаты с указанием страницы
Плагин Zotero со встроенным MCP-сервером: агент ищет по библиотеке, читает PDF и заметки, работает с аннотациями и метаданными
MCP-сервер, который превращает PDF, DOCX, XLSX, PPTX, изображения, аудио, веб-страницы и расшифровки YouTube в Markdown
MCP PDF от ComPDF: агент конвертирует PDF и изображения в Word, Excel, Markdown и JSON, объединяет, режет, защищает и сравнивает файлы через облачный API
MCP-сервер для создания и правки файлов Excel без установленного Microsoft Office: формулы, форматы, графики, сводные таблицы
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Ebook-MCP (эта запись) | нет | не нужна | 394 | |
| pdf-mcp | нет | не нужна | 155 | сервер только для PDF с гибридным поиском по папке, таблицами и OCR |
| Citra | да | не нужна | 1 050 | чтение PDF со структурным текстом, таблицами и цитатами с номером страницы |
| MarkItDown | да | не нужна | 191 675 | преобразует файлы в Markdown целиком, а не читает книгу по главам |
Коротко о README
В документации описаны сценарии (библиотека, чтение, обучение, навигация), длинный пример диалога с DeepSeek, списки возможностей для EPUB и PDF, установка клонированием, запуск в режиме разработки и в рабочем режиме, пример конфигурации для Cursor, справочник функций с сигнатурами и список зависимостей: ebooklib, PyMuPDF, BeautifulSoup, html2text, fastmcp.