Zotero MCP — ваша исследовательская библиотека в Claude

Zotero MCP связывает вашу библиотеку Zotero с Claude и другими AI-помощниками через Model Context Protocol. Вы можете обсуждать статьи, получать краткие выжимки, анализировать цитирования и многое другое — прямо из чата с ИИ.

Быстрая установка

pip install git+https://github.com/54yyyu/zotero-mcp.git
zotero-mcp setup        # автоматическая настройка для Claude Desktop

Возможности

• Поиск по библиотеке — находите книги, статьи и другие материалы по названию, автору, содержанию. Сложные запросы с несколькими условиями. Просмотр коллекций, тегов и недавно добавленного.
• Доступ к содержимому — подробная метаинформация, полный текст (если доступен), вложения, заметки и дочерние элементы.

Настройка и использование

Для Claude Desktop

После установки можно либо запустить автонастройку:

zotero-mcp setup

Либо вручную добавить запись в claude_desktop_config.json:

{
  "mcpServers": {
    "zotero": {
      "command": "zotero-mcp",
      "env": {
        "ZOTERO_LOCAL": "true"
      }
    }
  }
}

Требования

• Python 3.10+
• Zotero 7+ (для локального API с полным текстом)
• Claude Desktop или совместимая AI-программа

Как пользоваться в Claude

1. Запустите Zotero desktop (убедитесь, что локальный API включён в настройках).
2. Запустите Claude Desktop.
3. Используйте инструмент Zotero-MCP через интерфейс инструментов Claude.

Примеры запросов:

• «Поищи в моей библиотеке статьи по машинному обучению»
• «Найди недавно добавленные статьи об изменении климата»
• «Суммируй ключевые выводы из моей статьи о квантовых вычислениях»

Расширенная конфигурация

Использование веб-API вместо локального

Для удалённого доступа к библиотеке через веб-API Zotero:

zotero-mcp setup --no-local --api-key YOUR_API_KEY --library-id YOUR_LIBRARY_ID

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

• ZOTERO_LOCAL=true — использовать локальный API (по умолчанию false)
• ZOTERO_API_KEY — API-ключ Zotero (для веб-API)
• ZOTERO_LIBRARY_ID — ID библиотеки
• ZOTERO_LIBRARY_TYPE — тип библиотеки: user или group (по умолчанию user)

Параметры командной строки

• zotero-mcp serve — запустить сервер напрямую
• zotero-mcp serve --transport stdio | sse — указать транспорт
• zotero-mcp setup --help — справка по параметрам настройки

Доступные инструменты

Поиск

• zotero_search_items — поиск по библиотеке
• zotero_advanced_search — сложный поиск
• zotero_get_collections — список коллекций
• zotero_get_collection_items — элементы коллекции
• zotero_get_tags — все теги
• zotero_get_recent_items — недавно добавленные

Содержимое

• zotero_get_item_metadata — детальная метаинформация
• zotero_get_item_fulltext — полный текст
• zotero_get_item_children — вложения и заметки

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

• Нет результатов — убедитесь, что Zotero запущен и локальный API включён.
• Не удаётся подключиться к библиотеке — проверьте API-ключ и ID библиотеки (при использовании веб-API).
• Полный текст недоступен — для локального доступа к полному тексту нужен Zotero 7+.

Лицензия

MIT