autoContents MCP
Строит переходные закладки в отсканированном PDF по странице оглавления и работает как MCP-сервер для Claude Desktop
- 273 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Страницы документа отправляются провайдеру модели по ключу API, поэтому конфиденциальные сканы нельзя загружать, не изучив условия провайдера
- Программа записывает PDF с закладками и хранит ключ API в файле `.env` или в переменных окружения клиента
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/autocontentsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Страницы документа отправляются провайдеру модели по ключу API, поэтому конфиденциальные сканы нельзя загружать, не изучив условия провайдера
- Программа записывает PDF с закладками и хранит ключ API в файле `.env` или в переменных окружения клиента
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
autoContents расставляет закладки в отсканированном PDF, у которого есть страница оглавления. Страницы превращаются в картинки, модель с поддержкой изображений читает названия глав и номера страниц, а программа записывает готовые закладки в документ. По README обработка занимает около минуты. Уровни вложенности определяет отдельный шаг. Римские номера предисловия пересчитываются в смещение относительно основной нумерации, поэтому главы после предисловия попадают на свои страницы. Подходят книги и документы на китайском и английском, если оглавление напечатано на странице. Запускать программу можно двумя способами. Первый — локальная веб-страница на Flask: PDF перетаскивают в окно, а ключ API, адрес сервиса и модель задают в настройках или в файле `.env`. Второй — MCP-сервер из файла `mcp_server.py` с инструментами `generate_pdf_bookmarks` и `check_llm_config`, которые вызывает агент. Модель берется любая с OpenAI-совместимым API и поддержкой изображений. В README перечислены Qwen, InternAI, OpenAI и DeepSeek.
Для кого. Тем, кто работает с отсканированными книгами, диссертациями и отчетами и хочет получить в PDF рабочую панель закладок без ручной разметки.
Подходит, если
- Отсканированная книга открывается без панели закладок, а оглавление напечатано на одной из первых страниц
- В предисловии римская нумерация, и закладки глав должны попадать на правильные страницы основной части
- Нужно запустить построение закладок из чата Claude Desktop вызовом инструмента `generate_pdf_bookmarks`
- Модель для разметки надо сменить на другую с OpenAI-совместимым API без правки кода
Не подходит, если
- У документа нет страницы оглавления: программа читает эту страницу, а закладки по тексту глав не строит
- Файл конфиденциален, и картинки его страниц нельзя отправлять внешнему провайдеру модели
- Нужен поиск по тексту сканов: инструмент расставляет закладки и слой распознанного текста не создает
- Документ на другом языке или с нестандартной версткой оглавления, которую вы не проверяли на примере
Пример запроса к агенту
Построй закладки для scan-book.pdf по странице оглавления и сохрани результат рядом с исходным файломMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
AUTOCONTENTS_API_KEYобязательная, секрет- Ключ API сервиса с моделью, которая принимает изображения
AUTOCONTENTS_BASE_URL- Адрес OpenAI-совместимого сервиса, по умолчанию совместимый интерфейс Alibaba Bailian
AUTOCONTENTS_MODEL- Название модели, по умолчанию `qwen3.5-397b-a17b`
Ограничения
- Модель должна принимать изображения, а ключ API обязателен. Страницы, которые читает модель, уходят выбранному провайдеру.
- По README подходят документы с отдельной страницей оглавления, на китайском или английском языке.
- Для режима MCP нужны менеджер пакетов `uv` и Python 3.13 или новее, а путь к проекту в конфигурации клиента заменяют на свой.
- GitHub не определил лицензию автоматически, поэтому условия использования читайте в файле `LICENSE` репозитория.
- Интерфейс и документация на китайском, подсказок на английском в README мало.
Как отключить. Удалите блок `autoContents` из раздела `mcpServers` в конфигурации клиента и перезапустите клиент. Веб-версию остановите закрытием окна запуска. Папку программы можно удалить вместе с файлом `.env`, где лежит ключ API.
Частые вопросы
Что делает autoContents с PDF?
Программа читает страницу оглавления отсканированного документа через модель с поддержкой изображений и записывает в PDF закладки с переходами. По README результат приходит примерно через минуту.
Как подключить autoContents к Claude Desktop?
Добавьте в конфигурацию MCP блок с командой `uv`, аргументами `run --project <путь> python <путь>/mcp_server.py` и переменной `AUTOCONTENTS_API_KEY`, затем перезапустите клиент. В списке инструментов появятся `generate_pdf_bookmarks` и `check_llm_config`.
Какая модель подойдет?
Любая с OpenAI-совместимым API и поддержкой изображений. В README описана настройка Qwen через Alibaba Bailian и InternAI, для остальных нужны ключ, адрес сервиса и название модели. В режиме MCP по умолчанию стоит `qwen3.5-397b-a17b`.
Нужно ли ставить Python для обычной версии?
Нет. Архив из раздела Releases содержит файлы запуска `启动 autoContents.command` для macOS и `启动 autoContents.bat` для Windows, ни Python, ни зависимости ставить не нужно. Ключ API вводят на странице при первом запуске.
Куда уходят страницы документа?
Страницы, которые читает модель, отправляются провайдеру выбранной модели. Если внешний провайдер не подходит, укажите адрес собственной модели с OpenAI-совместимым интерфейсом и поддержкой изображений.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP PDF для больших документов: агент ищет по смыслу и по ключевым словам в одном файле или папке и читает только нужные страницы, таблицы и сканы
PageIndex MCP — длинные PDF для агента
PageIndex MCP
MCP-сервер дает агенту читать длинные PDF по дереву структуры документа: поиск рассуждением вместо векторной базы
MCP PDF от ComPDF: агент конвертирует PDF и изображения в Word, Excel, Markdown и JSON, объединяет, режет, защищает и сравнивает файлы через облачный API
PDF Tools для Claude Desktop и MCP-клиентов: заполнение форм, подпись, склейка, разделение и извлечение данных локально.
Извлечение PDF с самопроверкой: нечитаемые страницы получают пометку и не пропадают молча, плюс MCP-сервер для Claude
MCP-сервер на базе Docling: переводит PDF в структурированный документ, собирает новые документы и загружает их в RAG
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| autoContents (эта карточка) | нет | API-ключ | 273 | |
| pdf-mcp | нет | не нужна | 171 | читает готовый текстовый слой PDF |
| ComPDF MCP | да | API-ключ | 98 | обрабатывает PDF через облачные инструменты ComPDF и не строит закладки по оглавлению |
Коротко о README
Описание на китайском: инструмент для отсканированных PDF, версия 1.1.0. Автор благодарит участников, дает ссылки на архивы для macOS и Windows, объясняет настройку LLM-сервиса и ведет журнал обновлений. Отдельный раздел описывает запуск MCP-сервера через `uv`.