
PinRAG
ndjordjevicMIT
1 звёзд
PinRAG — MCP-сервер для Retrieval-Augmented Generation (RAG). Он собирает ваши материалы из разных источников и индексирует их в единую поисковую базу. В отличие от простого поиска по файлам, PinRAG понимает контекст запроса: вы спрашиваете на естественном языке, а сервер находит релевантные фрагменты и формирует ответ со ссылками на источники. Это избавляет от необходимости вручную искать информацию в PDF, пересматривать видео или перечитывать чаты Discord. Всё работает прямо из редактора кода или AI-ассистента.
Установка
uvx pinragХарактеристики
Общее
- СтатусСообщество
- Разработчикndjordjevic
- ЛицензияMIT
Технологии
- ЯзыкиPython
- Транспортstdio
Описание
Возможности
- Сканирует и индексирует PDF-файлы и электронные книги — извлекает текст для поиска.
- Клонирует репозитории GitHub по ссылке и индексирует их содержимое: код, документацию, описания.
- Для YouTube-видео извлекает расшифровку через URL, плейлист или ID.
- Включает vision-обогащение для YouTube: распознаёт код, диаграммы и интерфейсы на экране, смешивает их с текстом расшифровки в одном чанке.
- Импортирует экспортированные чаты из Discord и индексирует обсуждения по каналам.
- Индексирует локальные текстовые файлы и целые директории — рекурсивно обходит папки.
- Строит единый RAG-индекс из всех перечисленных источников — ищет по всему корпусу сразу.
- Возвращает ответы с точными цитатами: номер страницы, таймкод видео, путь к файлу или ссылка на сообщение в Discord.
- Управляет индексом: показывает список добавленных документов, удаляет выбранные записи.
- Работает через транспорт stdio по протоколу MCP.
Как подключить
Установите сервер через менеджер пакетов uv. Команда для терминала:
uvx pinragДобавьте конфигурацию в файл настроек вашего MCP-клиента. Пример для Claude Desktop:
{
"mcpServers": {
"pinrag": {
"command": "uvx",
"args": ["pinrag"]
}
}
}Перезапустите клиент, чтобы сервер подключился.
Примеры запросов
- «Найди в моих документах обоснование выбора архитектуры микросервисов и покажи цитаты из PDF и GitHub».
- «Посмотри это видео на YouTube, извлеки основные тезисы и сравни с описанием из приложенного файла».
- «Выгрузи список всех проиндексированных репозиториев и удали те, что относятся к старому проекту».
- «Найди в экспорте Discord-чата обсуждение проблемы деплоя на продакшн за последний месяц».
Технические детали
- Язык: Python
- Стек: LangChain, MCP Protocol
- Транспорт: stdio
- Лицензия: MIT
- Совместимые клиенты: Claude Desktop, Cursor, VS Code (GitHub Copilot), Zed, любой MCP-клиент