PageIndex MCP — длинные PDF для агента
PageIndex MCP
MCP-сервер дает агенту читать длинные PDF по дереву структуры документа: поиск рассуждением вместо векторной базы
- 406 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Локальный инструмент читает файл по пути, который назвал агент, и отправляет его в облачный сервис PageIndex
- Ключ API лежит в конфигурации клиента в заголовке запроса
Установка
- Работает в
Ручная установка
npx -y @pageindex/mcpЛокальный сервер с загрузкой локальных PDF, нужен Node.js 18 или новее.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Локальный инструмент читает файл по пути, который назвал агент, и отправляет его в облачный сервис PageIndex
- Ключ API лежит в конфигурации клиента в заголовке запроса
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
PageIndex MCP подключает к агенту систему PageIndex, которая строит из документа иерархическое дерево разделов и ищет нужное многошаговым рассуждением. Для разбора длинного PDF не нужны векторная база, нарезка на фрагменты и заранее заданное число лучших совпадений. Агент проходит по структуре документа так, как человек пользуется оглавлением книги, и приводит ход поиска, который можно проверить. Подключиться можно тремя способами. Разработчик берет ключ API в кабинете PageIndex и прописывает удаленный адрес https://api.pageindex.ai/mcp с заголовком Authorization. Пользователь приложения PageIndex входит по OAuth через адрес приложения или ставит готовый пакет .mcpb в Claude Desktop двойным щелчком. Для локальных файлов запускается собственный сервер командой `npx -y @pageindex/mcp`. Локальный сервер добавляет инструмент process_document: он принимает ссылку на PDF или путь к файлу, загружает документ в сервис и отправляет на обработку. Остальные инструменты сервер берет у удаленной стороны PageIndex.
Для кого. Для тех, кто работает с длинными PDF в Claude, Cursor или своем агенте на SDK и упирается в лимит контекста при чтении целого документа.
Подходит, если
- Длинный отчет, договор или книга не помещается в окно контекста, и агент выдает ошибку о достижении лимита
- Нужны ответы с прозрачным ходом поиска по разделам документа, который можно проверить
- Вы строите агента на Claude Agent SDK, Vercel AI SDK, OpenAI Agents SDK или LangChain и ищете подключаемый поиск по документам без векторной базы
- Файлы лежат на компьютере, и сервер должен принять локальный PDF или документ по ссылке
- Нужен один и тот же способ работы с PDF в нескольких клиентах, от Claude Desktop до собственного кода
Не подходит, если
- Документ нельзя отправлять во внешний сервис: файл загружается в PageIndex на обработку
- Нужны форматы, кроме PDF: инструмент загрузки принимает только PDF
- Нужна работа без интернета: сервер обращается к удаленной стороне PageIndex
- Вам нужен собственный стек поиска на векторной базе, которым вы управляете сами: PageIndex работает как размещенный сервис
Пример запроса к агенту
Загрузи в PageIndex файл ~/Documents/annual-report.pdf и найди в нем раздел о ликвидности, укажи страницы.MCP
- Транспорт
- stdio, http
- Авторизация
- OAuth
Ограничения
Нужен аккаунт PageIndex: либо ключ API из кабинета разработчика, либо вход в приложение по OAuth. Бесплатно доступно 1000 страниц, дальше действуют условия сервиса. Локальный запуск требует Node.js 18 или новее.
Инструмент загрузки обрабатывает только PDF. Документ уходит на сервер PageIndex, поэтому конфиденциальные файлы лучше сначала проверить на допустимость такой передачи. Сроки хранения и режим обработки данных описаны на сайте сервиса, в репозитории их нет. Доступность сервиса из России при подготовке карточки не проверялась.
Как отключить. Уберите запись pageindex из конфигурации MCP-клиента. Пакет .mcpb удалите в Claude Desktop на странице расширений. Ключ API отзовите в кабинете разработчика PageIndex.
Частые вопросы
Как подключить PageIndex MCP к Claude Desktop?
Скачайте файл .mcpb со страницы релизов репозитория и откройте его двойным щелчком, вход по OAuth выполнится сам. Для других клиентов добавьте в конфигурацию адрес https://app.pageindex.ai/mcp.
Чем PageIndex отличается от обычного RAG на векторной базе?
Документ превращается в дерево разделов, и модель ищет по нему рассуждением, как по оглавлению книги. Нарезки на фрагменты и векторной базы нет, число лучших совпадений заранее не задается, ход поиска можно проследить.
Нужен ли ключ API?
Для подключения из кода и SDK нужен ключ из кабинета разработчика PageIndex, он передается в заголовке Authorization. Если у вас есть аккаунт приложения PageIndex, клиент входит через OAuth без ключа.
Можно ли читать локальный PDF?
Да, для этого запустите локальный сервер командой npx -y @pageindex/mcp. Инструмент process_document принимает путь к файлу или ссылку, загружает документ в сервис через подписанный адрес и отправляет на обработку. Папку для результата можно задать параметром folder_id.
С какими фреймворками работает PageIndex MCP?
Кроме Claude и Cursor подключение описано для Claude Agent SDK, Vercel AI SDK, OpenAI Agents SDK и LangChain. Подойдет любой клиент с поддержкой MCP.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP PDF для больших документов: агент ищет по смыслу и по ключевым словам в одном файле или папке и читает только нужные страницы, таблицы и сканы
MCP-сервер на базе Docling: переводит PDF в структурированный документ, собирает новые документы и загружает их в RAG
MCP-сервер для чтения PDF: структурный текст, таблицы, OCR, визуальные вырезки и цитаты с указанием страницы
MCP PDF от ComPDF: агент конвертирует PDF и изображения в Word, Excel, Markdown и JSON, объединяет, режет, защищает и сравнивает файлы через облачный API
MCP-сервер, который превращает PDF, DOCX, XLSX, PPTX, изображения, аудио, веб-страницы и расшифровки YouTube в Markdown
Локальная база документов для агента: гибридный поиск по смыслу и словам и веб-интерфейс для просмотра и загрузки
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| PageIndex MCP — длинные PDF для агента (эта запись) | да | OAuth | 406 | |
| pdf-mcp | нет | не нужна | 162 | локальный поиск по смыслу и ключевым словам внутри одного файла или папки |
| Citra | да | не нужна | 1 058 | чтение PDF с таблицами, распознаванием текста и цитатами по страницам |
| MCP Local RAG | нет | не нужна | 425 | локальный поиск по документам на векторной базе без ключей |
Коротко о README
Сервер написан на TypeScript. В репозитории есть манифест manifest.json для Claude Desktop и файл server.json для реестра MCP, а подключение описано тремя вариантами с готовыми блоками конфигурации.