Zotero

Подключите свою библиотеку Zotero к AI-ассистентам с помощью Zotero MCP. Ищите, получайте метаданные и доступ к полным текстам через Model Context Protocol. Улучшите свой исследовательский процесс!

Обучение и документация Продуктивность и workflow Data Science и ML ★ 150 GitHub (150 ★)

Обеспечивает доступ к вашей библиотеке Zotero в AI-ассистентах путём реализации сервера Model Context Protocol (MCP). Этот сервер предоставляет упрощённый набор взаимодействий с Zotero, открывая такие функции, как поиск элементов, получение подробных метаданных и доступ к полному тексту для использования с MCP-клиентами и инструментами, такими как MCP Inspector. AI-ассистенты затем могут использовать эту информацию для создания более релевантных и полезных ответов на запросы пользователей.

Ключевые особенности

01Поиск элементов в вашей библиотеке Zotero с помощью текстовых запросов.

02Получение подробных метаданных для конкретных элементов Zotero.

03Доступ к полному тексту (PDF-содержимому) элементов Zotero.

04Интеграция с любым MCP-клиентом.

05Поддержка как локального Zotero API, так и Zotero Web API.

Варианты использования

01Используйте AI-ассистентов, таких как Claude, для поиска и обобщения научных статей.

02Быстрое получение метаданных для цитирования в AI-средах.

03Доступ к полному тексту научных статей из AI-рабочих процессов.

Model Context Protocol server for Zotero

This project is a python server that implements the Model Context Protocol (MCP) for Zotero, giving you access to your Zotero library within AI assistants. It is intended to implement a small but maximally useful set of interactions with Zotero for use with MCP clients.

Features

This MCP server provides the following tools:

zotero_search_items: Search for items in your Zotero library using a text query
zotero_item_metadata: Get detailed metadata information about a specific Zotero item
zotero_item_fulltext: Get the full text of a specific Zotero item (i.e. PDF contents)

These can be discovered and accessed through any MCP client or through the MCP Inspector.

Each tool returns formatted text containing relevant information from your Zotero items, and AI assistants such as Claude can use them sequentially, searching for items then retrieving their metadata or text content.

Installation

To use this with Claude Desktop, add the following to the mcpServers configuration:

{
  "mcpServers": {
    "zotero": {
      "command": "uvx",
      "args": ["zotero-mcp"],
      "env": {
        "ZOTERO_LOCAL": "true"
      }
    }
  }
}

The ZOTERO_LOCAL setting points the plugin to the local Zotero API and requires Zotero 7 (or the beta version, see note below) running on the same machine as the client.

To use the Zotero Web API, you'll need to create an API key and find your Library ID (usually your User ID) in your Zotero account settings here: https://www.zotero.org/settings/keys

The following environment variables provide configuration options:

ZOTERO_LOCAL=true: Use the local Zotero API (default: false, see note below)
ZOTERO_API_KEY: Your Zotero API key (not required for the local API)
ZOTERO_LIBRARY_ID: Your Zotero library ID (your user ID for user libraries, not required for the local API)
ZOTERO_LIBRARY_TYPE: The type of library (user or group, default: user)

Important

For access to the fulltext API locally, an upcoming Zotero release is required. In the meantime you'll need to install a Zotero Beta Build for that functionality to work (as of 2025-03-07). See zotero/zotero#5004 for more information.

Development

Clone this repository
Install dependencies with uv by running: uv sync
Create a .env file in the project root with the environment variables above

Start the MCP Inspector for local development:

npx @modelcontextprotocol/inspector uv run zotero-mcp

Running Tests

To run the test suite:

uv run pytest

Relevant Documentation

Zotero MCP-сервер

Английский оригинал | Сервер для взаимодействия с библиотекой Zotero через протокол MCP (Model Context Protocol) в AI-ассистентах (Claude и другие).

Что это

Этот Python-сервер реализует MCP для доступа к вашей библиотеке Zotero из AI-помощников. Он предоставляет три инструмента, которые можно вызывать последовательно для поиска, получения метаданных и полных текстов PDF из Zotero.

Инструменты:

zotero_search_items — поиск по текстовому запросу в вашей библиотеке Zotero
zotero_item_metadata — получение подробной информации о конкретном элементе
zotero_item_fulltext — получение полного текста PDF-файла элемента

Каждый инструмент возвращает отформатированный текст. AI-ассистенты могут использовать их цепочкой: сначала найти элементы, затем запросить метаданные или содержимое.

Установка

Через Claude Desktop

Добавьте в конфигурацию mcpServers:

{
  "mcpServers": {
    "zotero": {
      "command": "uvx",
      "args": ["zotero-mcp"],
      "env": {
        "ZOTERO_LOCAL": "true"
      }
    }
  }
}

Переменная ZOTERO_LOCAL=true указывает на локальный API Zotero. Для этого нужен Zotero 7 (или бета-версия) на том же компьютере, что и клиент. Без этой настройки сервер будет пытаться подключиться к веб-API.

Для веб-API

Создайте API-ключ в настройках учётной записи: https://www.zotero.org/settings/keys
Найдите ваш Library ID (User ID) там же.

Настройте окружение:

ZOTERO_LOCAL=false
ZOTERO_API_KEY=ваш_ключ
ZOTERO_LIBRARY_ID=ваш_id
ZOTERO_LIBRARY_TYPE=user  # или group

Переменные окружения

Переменная	Описание	По умолчанию
`ZOTERO_LOCAL`	Использовать локальный API (`true`) или веб-API (`false`)	`false`
`ZOTERO_API_KEY`	API-ключ Zotero (не требуется для локального API)	—
`ZOTERO_LIBRARY_ID`	ID вашей библиотеки (User ID; не требуется для локального API)	—
`ZOTERO_LIBRARY_TYPE`	Тип библиотеки: `user` или `group`	`user`

Важное замечание по полному тексту

Для работы zotero_item_fulltext через локальный API требуется Zotero Beta Build (на дату 2025-03-07). Следите за обновлениями в репозитории: zotero/zotero#5004.

Разработка

Клонируйте репозиторий
Установите зависимости через uv: uv sync
Создайте .env в корне проекта с нужными переменными окружения
Запустите MCP Inspector для отладки:

npx @modelcontextprotocol/inspector uv run zotero-mcp

Тестирование

uv run pytest

Полезные ссылки

Источник: https://mcpmarket.com/server/zotero

Zotero

Ключевые особенности

Варианты использования

Model Context Protocol server for Zotero

Features

Installation

Development

Running Tests

Relevant Documentation

Zotero MCP-сервер

Что это

Установка

Через Claude Desktop

Для веб-API

Переменные окружения

Важное замечание по полному тексту

Разработка

Тестирование

Полезные ссылки

Что такое Zotero MCP?

Как работает Zotero MCP?

Какие функции предлагает Zotero MCP?

Какие требования для использования Zotero MCP?

Что такое Model Context Protocol?

Zotero Item Metadata

Parameters

Zotero Item Fulltext

Parameters

Zotero Search Items

Parameters

Комментарии