litdb CLI
litdb собирает вашу научную литературу в локальную базу с семантическим поиском и дает агенту скилл и MCP-сервер для чтения
- 86 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Индексирует ваши файлы и ходит в OpenAlex и CrossRef по сети
- MCP-сервер отдает агенту содержимое вашей базы статей для чтения
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/litdbОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Индексирует ваши файлы и ходит в OpenAlex и CrossRef по сети
- MCP-сервер отдает агенту содержимое вашей базы статей для чтения
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
litdb — инструмент для сбора и использования коллекции научных статей: добавляете работы, ищете запросами на естественном языке, следите за новыми статьями и читаете старые. Поиск идет через модели SentenceTransformer, данные приходят из OpenAlex, CrossRef и локальных файлов, а общаться можно и с моделью через ollama. Для агентов вроде Claude Code, VS Code с GitHub Copilot, Cursor, Codex, OpenCode и Gemini CLI есть два артефакта. Скилл `skills/litdb/SKILL.md` учит агента работать с CLI: добавлять статьи, искать, фильтровать, ставить теги и выгружать BibTeX. MCP-сервер `litdb_mcp` дает агенту инструменты только для чтения: `vsearch`, `fulltext_search`, `find_similar`, `openalex`, `get_source_details`, `get_citation`, `get_bibtex`, `list_tags` и `get_tagged_articles`. В версии 2.1.8 добавлены `fromtext` для извлечения ссылок из вставленного текста, `summary` для дайджестов новых статей, `extract` для таблиц из PDF и `schema` для структурированных данных из документов. Конфигурация лежит в `litdb.toml`.
Для кого. Исследователям, которые копят статьи и хотят искать по ним естественным языком, а агенту отдать эту базу для чтения и цитат.
Подходит, если
- В базе сотни статей по теме, и нужны похожие на конкретную работу
- Агент должен подобрать BibTeX и ссылки из вашей коллекции без обращения к внешним сервисам
- Из вставленного списка литературы надо собрать записи с подбором по CrossRef
- Новые статьи по теме надо пролистывать в виде короткой сводки
Не подходит, если
- Нужен лишь менеджер ссылок без семантического поиска: проект тянет много ML-зависимостей
- Статьи хранятся в облачном менеджере, и заводить локальную копию не хочется
- Нужна обработка премиальных фильтров OpenAlex без платного ключа
Пример запроса к агенту
Найди в моей базе litdb статьи, похожие на эту работу, и выгрузи BibTeX для трех самых близкихОграничения
- У проекта много ML-зависимостей, конфликты версий частые: автор советует ставить через `uv`.
- Перед работой создается файл `litdb.toml` с выбором модели SentenceTransformer, размера векторов и параметров нарезки текста.
- Функция `update-filters` требует премиальный ключ OpenAlex.
- MCP-сервер дает инструменты только для чтения, добавлять статьи нужно через CLI.
- Часть возможностей, например `fromtext`, опирается на разбор моделью и на CrossRef, поэтому нужна сеть.
Как отключить. Удалите пакет командой `uv tool uninstall litdb` или `pip uninstall litdb`, скилл и запись MCP уберите из настроек агента.
Частые вопросы
Какие инструменты дает MCP-сервер litdb?
Девять инструментов только для чтения: поиск по векторам и полному тексту, похожие статьи, запросы к OpenAlex, цитаты, BibTeX и теги.
Как поставить litdb без конфликтов зависимостей?
Через `uv`: `uv venv --python 3.13`, затем `uv pip install litdb`, или `uv tool install litdb`, чтобы команды попали в PATH.
С какими агентами работает?
Скилл и MCP подходят для Claude Code, VS Code с GitHub Copilot, Cursor, Codex, OpenCode и Gemini CLI; ставятся проще всего через knowhow.
Откуда берутся статьи?
Из OpenAlex, CrossRef и локальных файлов, дальше они индексируются локально.
Что делает команда fromtext?
Извлекает ссылки из вставленного текста через разбор моделью и сопоставление с CrossRef и добавляет их в базу.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛокальный MCP-сервер для работы с научной литературой arXiv: чтение статей по разделам, BibTeX из метаданных, отслеживание тем
Скилл ищет научные статьи сразу в пяти открытых базах и собирает офлайн-отчет с релевантностью, BibTeX и поисковыми запросами.
CLI на Python компилирует книгу в устанавливаемый Agent Skill: знание-справочник и поведенческий скилл с проверкой цитат по тексту
Скилл Zotero Literature Visualizer ищет статьи, сортирует библиотеку Zotero и строит интерактивный дашборд литературы.
Проверка BibTeX по Crossref, OpenAlex, PubMed и arXiv: CLI, API на Python и MCP-сервер для поиска ошибочных ссылок
Скилл Claude Code для научных обзоров: интервью, поиск по Scopus и OpenAlex, проверка каждого DOI и итоговый файл docx
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| litdb (эта карточка) | нет | 86 | ||
| Zotero Research Assistant Skill | нет | 98 | работает с библиотекой Zotero через свой CLI, а litdb ведет собственную базу с семантическим поиском | |
| zotero-mcp — MCP-сервер для библиотеки Zotero | нет | ключ необязателен | 162 | MCP открывает библиотеку Zotero, а litdb хранит локальную базу с векторами и OpenAlex |
Коротко о README
README объясняет идею базы литературы, перечисляет видеоуроки, установку через `pip` и `uv`, новинки версии 2.1.8 и настройку `litdb.toml`. Отдельный раздел описывает скилл и MCP-сервер для агентов и установку через knowhow.