Zoteus — библиотека Zotero в Claude и ChatGPT
Zoteus
MCP-сервер для Zotero: поиск по словам и смыслу, цитаты из PDF со страницами, ссылки в CSL и добавление статей по DOI
- 65 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агент пишет в библиотеку Zotero: добавляет записи, теги и аннотации, поэтому ошибка попадет в ваши данные
- Содержимое PDF и заметок попадает в контекст агента и может нести чужие инструкции
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/zoteusОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент пишет в библиотеку Zotero: добавляет записи, теги и аннотации, поэтому ошибка попадет в ваши данные
- Содержимое PDF и заметок попадает в контекст агента и может нести чужие инструкции
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Zoteus дает агенту доступ к библиотеке Zotero. Инструменты с префиксом zotero_ ищут по названиям, аннотациям, авторам и тегам гибридным поиском по ключевым словам и смыслу, находят фрагменты в тексте PDF с номерами страниц и показывают страницы и рисунки как изображения. Ссылки и библиографию собирает citeproc-js в любом стиле CSL. Статью добавляют по DOI или идентификатору arXiv: метаданные подтягиваются встроенными резолверами, а сервер перевода Zotero расширяет это на ISBN, PMID и адреса. Запись идет в версионированном режиме с повторами при конфликтах, корзина обратима, окончательное удаление отключено и требует подтверждения. На Zotero 10 и новее агент пишет прямо в запущенное приложение без облачного ключа и создает выделения и заметки в PDF через zotero_annotate. Семантический поиск строит локальный индекс на SQLite и по умолчанию считает эмбеддинги на устройстве, а также умеет работать через Ollama, OpenAI и Gemini.
Для кого. Исследователям и студентам, у которых литература лежит в Zotero и которым нужны точные цитаты, ссылки и поиск по смыслу.
Подходит, если
- Надо найти в PDF библиотеки место, где автор говорит об определенном методе, и процитировать его со страницей
- Нужно собрать таблицу доказательств по десятку статей с цитатами
- Список литературы к тексту должен выйти в стиле ГОСТ или APA из выбранных записей
- Статью по DOI хочется добавить в коллекцию и сразу проставить теги
- Выделения и заметки в PDF стоит разобрать по темам
Не подходит, если
- Библиотека не в Zotero: сервер умеет работать только с ним
- Агент не должен менять библиотеку: запись и аннотации включены, поэтому доступ стоит ограничить ключом только на чтение
- Нужен семантический поиск по телу каждого PDF без затрат: индексация полного текста включается отдельно и стоит дорого
Пример запроса к агенту
Найди в моей библиотеке статьи про трансформеры для временных рядов, процитируй по абзацу с номером страницы и оформи список в стиле APA.MCP
- Транспорт
- stdio, http
- Авторизация
- ключ необязателен
Переменные окружения
ZOTERO_API_KEYсекрет- Ключ API Zotero для синхронизации и групповых библиотек
ZOTEUS_ALLOW_DELETE- Значение true разрешает окончательное удаление записей
ZOTEUS_EMBEDDINGS- Источник эмбеддингов: local, ollama, openai, gemini или off
Ограничения
Для чтения и записи в приложении нужен запущенный Zotero, а запись через приложение доступна на Zotero 10 и новее. Облачный ключ API нужен для синхронизации, групповых библиотек, которых нет в приложении, и работы без него. В настройках Zotero включите разрешение другим приложениям на этом компьютере обращаться к нему. Хостинговый вариант Zoteus платный, он подключается к claude.ai и ChatGPT как удаленный коннектор. Окончательное удаление работает только при ZOTEUS_ALLOW_DELETE=true. Локальные эмбеддинги скачивают модель размером около 129 МБ в варианте q8.
Как отключить. Выполните claude mcp remove zoteus или удалите расширение .mcpb в Claude Desktop. Ключ API отзовите на странице zotero.org/settings/keys, локальный индекс удалите вместе с папкой данных сервера.
Частые вопросы
Как поставить Zoteus в Claude Code?
Командой claude mcp add --transport stdio zoteus -- npx -y @oscardvs/zoteus либо через плагин: /plugin marketplace add oscardvs/zoteus и /plugin install zoteus@zoteus. Плагин добавляет четыре исследовательских навыка.
Нужен ли ключ Zotero?
Для чтения и для записи в запущенное приложение на Zotero 10 и новее облачный ключ не нужен. Ключ добавляют для синхронизации и групп, которых нет в приложении. Его выдают на zotero.org/settings/keys.
Где считается семантический поиск?
По умолчанию на вашем устройстве через локальную модель. В ZOTEUS_EMBEDDINGS можно выбрать ollama, openai, gemini или отключить эмбеддинги значением off.
Можно ли удалять записи?
Корзина обратима, а окончательное удаление zotero_delete_items отказывает, пока не задано ZOTEUS_ALLOW_DELETE=true, и требует подтверждения.
Какие клиенты поддерживаются?
Claude Desktop через пакет .mcpb, Claude Code, Cursor, VS Code, Zed, Codex, Gemini CLI и любой клиент MCP. claude.ai и ChatGPT подключаются к хостинговому Zoteus или к вашему удаленному экземпляру.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер плагина seerai для Zotero дает агентам 46 инструментов: поиск по библиотеке и научным базам, обзоры, рабочая папка.
cli-anything-zotero — Zotero для ИИ-агентов
cli-anything-zotero
CLI zotero-cli управляет локальной библиотекой Zotero: поиск, импорт по DOI, экспорт BibTeX, PDF, заметки, цитаты в DOCX
Плагин Zotero со встроенным MCP-сервером: агент ищет по библиотеке, читает PDF и заметки, работает с аннотациями и метаданными
Локальный MCP-сервер позволяет агенту искать и читать вашу библиотеку Zotero, хранилище Obsidian и Apple Notes через ядро на C++
Скилл управляет библиотекой Zotero из терминала: поиск, добавление, заметки, коллекции и слияние дубликатов.
CLI и MCP-сервер для библиотеки научных статей: агент ищет, импортирует и читает статьи, ведет заметки Markdown в вашем хранилище
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Zoteus — библиотека Zotero в Claude и ChatGPT (эта карточка) | нет | ключ необязателен | 65 | |
| zotero-mcp — MCP-сервер для библиотеки Zotero | нет | ключ необязателен | 162 | MCP для Zotero с базовым доступом, без цитат из PDF и записи в приложение |
| Zotero Research Assistant Skill | нет | 98 | навык-помощник для Zotero, самостоятельного сервера не содержит |
Коротко о README
README начинается с установки по клиентам: бандлы .mcpb для Claude Desktop, команда для Claude Code, плагин с навыками, npx add-mcp для остальных. Дальше идут возможности, таблица переменных окружения и ссылки на руководства по удаленному доступу через OAuth.