Provides access to your Zotero library, allowing you to search for items, retrieve detailed metadata, and access the full text contents of PDFs and other documents stored in your Zotero collection.
Этот проект представляет собой сервер Python, реализующий протокол контекста модели (MCP) для Zotero , предоставляя вам доступ к вашей библиотеке Zotero в помощниках AI. Он предназначен для реализации небольшого, но максимально полезного набора взаимодействий с Zotero для использования с клиентами MCP .
Этот сервер MCP предоставляет следующие инструменты:
zotero_search_items : Поиск элементов в вашей библиотеке Zotero с помощью текстового запросаzotero_item_metadata : Получить подробную информацию о метаданных определенного элемента Zoterozotero_item_fulltext : Получить полный текст определенного элемента Zotero (т. е. содержимое PDF)Их можно обнаружить и получить к ним доступ через любой клиент MCP или через MCP Inspector .
Каждый инструмент возвращает форматированный текст, содержащий соответствующую информацию из ваших элементов Zotero, а помощники на основе искусственного интеллекта, такие как Клод, могут использовать их последовательно, выполняя поиск элементов, а затем извлекая их метаданные или текстовое содержимое.
Этот сервер может работать либо с локальным API, предлагаемым приложением Zotero для настольных компьютеров , либо через Zotero Web API . Локальный API может быть немного более отзывчивым, но требует, чтобы приложение Zotero было запущено на том же компьютере с включенным API. Чтобы включить локальный API, выполните следующие действия:
[!ВАЖНО] Для доступа к конечной точке
/fulltextна локальном API, которая позволяет извлекать полное содержимое элементов в вашей библиотеке, вам необходимо установить сборку Zotero Beta (по состоянию на 2025-03-30). После выпуска версии 7.1 это больше не будет иметь места. Для получения дополнительной информации см. https://github.com/zotero/zotero/pull/5004 . Если вы не хотите этого делать, используйте вместо этого веб-API.
Чтобы использовать Zotero Web API, вам необходимо создать ключ API и найти свой идентификатор библиотеки (обычно это ваш идентификатор пользователя) в настройках вашей учетной записи Zotero здесь: https://www.zotero.org/settings/keys
Доступны следующие варианты конфигурации:
ZOTERO_LOCAL=true : использовать локальный API Zotero (по умолчанию: false, см. примечание ниже)ZOTERO_API_KEY : Ваш ключ API Zotero (не требуется для локального API)ZOTERO_LIBRARY_ID : Ваш идентификатор библиотеки Zotero (ваш идентификатор пользователя для пользовательских библиотек, не требуется для локального API)ZOTERO_LIBRARY_TYPE : Тип библиотеки (пользователь или группа, по умолчанию: пользователь)uvx с локальным API ZoteroЧтобы использовать это с Claude Desktop и прямой установкой Python с uvx , добавьте следующее в конфигурацию mcpServers :
Флаг --upgrade необязателен и будет загружать последнюю версию, когда появятся новые. Если у вас не установлен uvx , вы можете использовать pipx run вместо этого или клонировать этот репозиторий локально и использовать инструкции в разделе «Разработка» ниже.
Если вы хотите запустить этот сервер MCP в контейнере Docker, вы можете использовать следующую конфигурацию, вставив свой ключ API и идентификатор библиотеки:
Для обновления до новой версии запустите docker pull ghcr.io/kujenga/zotero-mcp:main . Также можно использовать установку на основе docker для взаимодействия с локальным API Zotero, но вам нужно будет изменить указанную выше команду, чтобы обеспечить сетевое подключение к локальному интерфейсу API приложения Zotero.
Информация о внесении изменений и участии в проекте.
uv sync.env в корне проекта с указанными выше переменными среды.Запустите MCP Inspector для локального развития:
Чтобы протестировать локальный репозиторий с помощью Claude Desktop, запустите echo $PWD/.venv/bin/zotero-mcp в своей оболочке в этом каталоге, затем установите следующее в конфигурации Claude Desktop:
Чтобы запустить тестовый набор:
Создайте образ контейнера с помощью этой команды:
Чтобы протестировать контейнер с помощью MCP-инспектора, выполните следующую команду:
You must be authenticated.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Этот сервер позволяет пользователям взаимодействовать со своей библиотекой Zotero через протокол контекста модели, предоставляя инструменты для поиска элементов, извлечения метаданных и доступа к полному тексту с помощью запросов на естественном языке.