Zotero MCP — Установка & Живое демо

Зачем использовать

Ключевые функции

Поиск по автору, названию, тегу, коллекции, полному тексту
Получение BibTeX/CSL-JSON для любой записи
Извлечение подсветок и аннотаций из PDF-вложений
Работает с локальным API Zotero 7 и Zotero Web API
Только чтение по умолчанию — безопасно подключать к исследовательской библиотеке

Живое демо

Как выглядит на практике

zotero-mcp.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

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

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

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

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "zotero-mcp",
      "command": "uvx",
      "args": [
        "zotero-mcp"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "zotero-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "zotero-mcp"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add zotero-mcp -- uvx zotero-mcp

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Zotero MCP

Синтезировать обзор литературы из отмеченных статей

👤 Аспиранты, исследователи ⏱ ~60 min intermediate

Когда использовать: Вы отметили 30 статей тегом #thesis-ch3 и вам нужно написать раздел 3.2.

Предварительные требования

Zotero запущен (локальный API включён) — Zotero 7: Настройки → Дополнительно → включить локальный API
API-ключ при использовании веб-версии — zotero.org/settings/keys

Поток

Получить набор

List every item tagged thesis-ch3 in my Zotero. Just titles + years + first author.✓ Скопировано

→ Чистый список, ~30 записей
Кластеризовать

Group those by methodological approach. Cite each item by zotero key.✓ Скопировано

→ 3–5 кластеров с цитированиями внутри каждого
Извлечь и написать

For cluster "quantitative RCTs", pull my highlights from each item and draft a synthesis paragraph with in-line citations.✓ Скопировано

→ Абзац с цитированиями (Автор, Год), подкреплёнными реальными подсветками

Итог: Готовый черновик раздела 3.2, который нужно редактировать, а не писать с нуля.

Подводные камни

PDF без подсветок, только сканы — Сначала запустите OCR в Zotero (правая кнопка → OCR PDF), затем запросите снова

Сочетать с: filesystem

Сгенерировать библиографию для пишущейся статьи

👤 Все, кто пишет в LaTeX ⏱ ~15 min beginner

Когда использовать: Вы процитировали 40 источников в черновике и вам нужен единый references.bib.

Поток

Найти цитирования

In /paper/main.tex, list every \cite{} key.✓ Скопировано

→ Все ключи цитирования перечислены
Разрешить

For each, pull BibTeX from Zotero and write the result to /paper/references.bib. Flag any key with no match.✓ Скопировано

→ bib-файл записан; неразрешённые цитирования перечислены

Итог: Чистый references.bib, привязанный к Zotero — без ручного копирования.

Подводные камни

Несовпадение ключей (Better BibTeX vs стандартный) — Установите расширение Better BibTeX в Zotero для стабильных фиксированных ключей

Сочетать с: filesystem

Комбинации

Сочетайте с другими MCP — эффект x10

zotero-mcp + filesystem

Записать извлечённый синтез в черновик статьи

Write the synthesis from Zotero into /paper/section-3-2.md.✓ Скопировано

zotero-mcp + memory

Запоминать ключевые аргументы по каждой статье между сессиями

Store the 1-sentence thesis of each item from cluster A in memory.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
search_items	query: str, tag?: str, collection?: str	Найти записи в библиотеке	free
get_item	key: str	Подробно изучить одну запись	free
get_annotations	key: str	Получить ваши подсветки и заметки к PDF	free
get_bibtex	keys: str[]	Составить библиографию для черновика	free
list_collections	none	Навигация по структуре библиотеки	free

Стоимость и лимиты

Во что обходится

Квота API: Локальный API: без ограничений. Веб API: с ограничениями от Zotero.
Токенов на вызов: Метаданные записи ~200 токенов; аннотации могут быть объёмными
Деньги: Бесплатно
Совет: Предпочитайте search_items с фильтрами по тегам вместо листинга всех записей

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: library:read

Хранение учётных данных: API-ключ в переменной окружения (только для веб-режима)

Исходящий трафик: api.zotero.org (веб-режим) или localhost (локальный режим)

Никогда не давайте: library:write unless truly needed

Устранение неполадок

Частые ошибки и исправления

ECONNREFUSED localhost:23119

Zotero не запущен или локальный API отключён. Откройте Zotero; Настройки → Дополнительно → включить локальный API.

Проверить: `curl http://localhost:23119/api/users/0/items`

Web API 403

В API-ключе нет прав на чтение библиотеки. Перегенерируйте на zotero.org/settings/keys.

Ключи BibTeX автоматически генерируются в непонятном формате

Установите дополнение Better BibTeX и настройте стабильный формат citekey

Альтернативы

Zotero MCP в сравнении

Альтернатива	Когда использовать	Компромисс
Obsidian MCP	Ваши заметки в Obsidian, а не в Zotero	Другая модель данных — не ориентирована на статьи
Direct Zotero CSL export	Разовый экспорт без участия LLM	Нет запросов, нет синтеза

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills