zotero-mcp — MCP-сервер для библиотеки Zotero
zotero-mcp
Легкий MCP-сервер на Python открывает ИИ-ассистенту вашу библиотеку Zotero: поиск, метаданные и полный текст PDF
- 162 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент читает вашу библиотеку и полные тексты статей; они уходят в модель
- Ключ веб-API дает доступ к библиотеке, его надо хранить как секрет
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/kujenga-zotero-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент читает вашу библиотеку и полные тексты статей; они уходят в модель
- Ключ веб-API дает доступ к библиотеке, его надо хранить как секрет
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает ассистенту три инструмента для чтения библиотеки Zotero. zotero_search_items ищет материалы по текстовому запросу. zotero_item_metadata возвращает все заполненные поля записи: сведения о публикации, идентификаторы, даты и данные библиотеки. zotero_item_fulltext отдает полный текст, то есть содержимое PDF. Ассистент вызывает их по цепочке: сначала находит источники, затем запрашивает метаданные или текст нужных. Каждый ответ приходит отформатированным текстом. Автор сознательно ограничился небольшим, но полезным набором операций. Сервер подключается к библиотеке двумя путями. Локальный API работает через запущенное приложение Zotero на том же компьютере, он быстрее. Веб-API Zotero работает по ключу и идентификатору библиотеки, личной или групповой. Запускается сервер через uvx или в контейнере Docker.
Для кого. Исследователям и студентам с большой библиотекой в Zotero, которые хотят задавать ассистенту вопросы по своим статьям и книгам.
Подходит, если
- Нужно найти в библиотеке работы по теме и получить их метаданные для списка литературы
- Требуется выжимка из полного текста конкретной статьи, лежащей у вас в Zotero
- Надо проверить, есть ли в библиотеке источник с определенным DOI или автором
- Вы пишете обзор и хотите, чтобы ассистент собрал ключевые тезисы из нескольких PDF
Не подходит, если
- Нужно добавлять или править записи: сервер только читает, записывающих инструментов в списке нет
- Источники лежат вне Zotero, в обычных папках: для них пригоден файловый сервер или поиск по PDF
- Zotero не запущен и ключа веб-API нет: без одного из двух подключиться нельзя
Пример запроса к агенту
Найди в моей библиотеке Zotero статьи про разреженное внимание и перескажи выводы из полного текста самой свежей.MCP
- Транспорт
- stdio
- Авторизация
- ключ необязателен
Переменные окружения
ZOTERO_LOCAL- Значение true включает локальный API Zotero.
ZOTERO_API_KEYсекрет- Ключ веб-API Zotero, для локального режима не нужен.
ZOTERO_LIBRARY_ID- Идентификатор библиотеки (для личной это ваш ID).
Ограничения
Сервер только читает. Для локального режима в настройках Zotero на вкладке «Advanced» надо включить разрешение другим приложениям на этом компьютере обращаться к Zotero, и Zotero при этом должен быть запущен. Веб-режим требует ключа API и идентификатора библиотеки.
Полный текст доступен только для файлов, которые Zotero проиндексировал. В Docker подключение к локальному API требует отдельной настройки сети. Последний коммит сделан в августе 2026 года; проект небольшой и ограничен тремя инструментами.
Как отключить. Удалите запись zotero из конфигурации клиента. Ключ API при желании отзовите на странице zotero.org/settings/keys.
Частые вопросы
Какие инструменты есть у zotero-mcp?
Три, все на чтение: `zotero_search_items` для поиска по тексту, `zotero_item_metadata` для всех полей записи и `zotero_item_fulltext` для содержимого PDF.
Как подключить к Claude Desktop?
Добавьте в `mcpServers` запись с `"command": "uvx"` и `"args": ["zotero-mcp@latest"]`, а в `env` укажите `ZOTERO_LOCAL`, `ZOTERO_API_KEY` и `ZOTERO_LIBRARY_ID`. Если uvx нет, подойдет `pipx run`.
Работает ли сервер с групповыми библиотеками?
Да, переменная `ZOTERO_LIBRARY_TYPE` принимает значения `user` и `group`, по умолчанию стоит `user`. Идентификатор групповой библиотеки указывают в `ZOTERO_LIBRARY_ID`.
Нужен ли ключ API Zotero?
Для локального API нет: включите в настройках Zotero пункт «Allow other applications on this computer to communicate with Zotero» и задайте `ZOTERO_LOCAL=true`. Для веб-API нужны `ZOTERO_API_KEY` и `ZOTERO_LIBRARY_ID`, их берут на странице zotero.org/settings/keys.
Можно ли запустить сервер в Docker?
Да, образ ghcr.io/kujenga/zotero-mcp:main запускается через `docker run --rm -i` с переменными `ZOTERO_API_KEY` и `ZOTERO_LIBRARY_ID`. К локальному API Zotero из контейнера нужно отдельно настроить сетевую доступность.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный MCP-сервер Kibela ищет, читает и правит заметки, папки и комментарии вашей вики прямо из чата с ассистентом
MCP-сервер для вики BookStack: поиск и чтение по умолчанию, запись включается отдельно, права берутся из токена.
Семь скиллов и скрипты для цепочки Zotero, полный текст через MinerU, аналитические заметки в Obsidian и поиск по литературе
Obsidian MCP Server
obsidian-mcp-server
MCP-сервер для хранилища Obsidian: чтение, поиск и точечная правка заметок, разделов, frontmatter и тегов
MCP-сервер читает курсы, дедлайны, тесты и файлы из Moodle по официальному API без браузера и сторонних пакетов.
MCP-сервер для хранилища Obsidian через плагин Local REST API: поиск, чтение, дополнение и правка заметок
Коротко о README
README перечисляет три инструмента и два способа подключения: локальный API приложения Zotero и веб-API по ключу. Дальше идут переменные окружения, примеры конфигурации для uvx и Docker и раздел о разработке.