# MCP Zotero

Подключает библиотеку Zotero к ИИ-агенту: тот может искать источники, добавлять статьи по DOI и работать с PDF. Есть инструменты для цитирования в документах Word.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 38
- Автор: Xevos117
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Xevos117/mcp-zotero
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/mcp-zotero

## Что делает

Сервер даёт агенту доступ к операциям с библиотекой Zotero: поиск и организация записей, добавление статей по DOI, импорт PDF и чтение их полного текста. Доступны инструменты для вставки цитат в файлы Word. Инструкции по рабочим сценариям передаются при подключении, а описания инструментов помогают агенту разобраться в их использовании.

Для работы нужны Node.js 22 или новее, ключ Zotero API с правами чтения, записи и доступа к файлам, а также числовой `ZOTERO_USER_ID`. Сервер по умолчанию блокирует удаление записей и коллекций; доступ к удалению настраивается через `UNSAFE_OPERATIONS`. Это важно, если агенту предстоит менять библиотеку.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `ZOTERO_API_KEY`, `ZOTERO_USER_ID`, `ZOTERO_LIBRARY_TYPE`, `ZOTERO_LIBRARY_ID`, `UNPAYWALL_EMAIL`, `UNSAFE_OPERATIONS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env ZOTERO_API_KEY=<ZOTERO_API_KEY> --env ZOTERO_USER_ID=<ZOTERO_USER_ID> --env ZOTERO_LIBRARY_TYPE=<ZOTERO_LIBRARY_TYPE> --env ZOTERO_LIBRARY_ID=<ZOTERO_LIBRARY_ID> --env UNPAYWALL_EMAIL=<UNPAYWALL_EMAIL> --transport stdio mcp-zotero -- npx -y @xevos117/mcp-zotero
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add mcp-zotero --env ZOTERO_API_KEY=<ZOTERO_API_KEY> --env ZOTERO_USER_ID=<ZOTERO_USER_ID> --env ZOTERO_LIBRARY_TYPE=<ZOTERO_LIBRARY_TYPE> --env ZOTERO_LIBRARY_ID=<ZOTERO_LIBRARY_ID> --env UNPAYWALL_EMAIL=<UNPAYWALL_EMAIL> -- npx -y @xevos117/mcp-zotero
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-zotero": {
            "command": "npx",
            "args": [
                "-y",
                "@xevos117/mcp-zotero"
            ],
            "env": {
                "ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
                "ZOTERO_USER_ID": "<ZOTERO_USER_ID>",
                "ZOTERO_LIBRARY_TYPE": "<ZOTERO_LIBRARY_TYPE>",
                "ZOTERO_LIBRARY_ID": "<ZOTERO_LIBRARY_ID>",
                "UNPAYWALL_EMAIL": "<UNPAYWALL_EMAIL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-zotero": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@xevos117/mcp-zotero"
            ],
            "env": {
                "ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
                "ZOTERO_USER_ID": "<ZOTERO_USER_ID>",
                "ZOTERO_LIBRARY_TYPE": "<ZOTERO_LIBRARY_TYPE>",
                "ZOTERO_LIBRARY_ID": "<ZOTERO_LIBRARY_ID>",
                "UNPAYWALL_EMAIL": "<UNPAYWALL_EMAIL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e ZOTERO_API_KEY=<ZOTERO_API_KEY> -e ZOTERO_USER_ID=<ZOTERO_USER_ID> -e ZOTERO_LIBRARY_TYPE=<ZOTERO_LIBRARY_TYPE> -e ZOTERO_LIBRARY_ID=<ZOTERO_LIBRARY_ID> -e UNPAYWALL_EMAIL=<UNPAYWALL_EMAIL> mcp-zotero npx -y @xevos117/mcp-zotero
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

## Когда брать
- найти записи в библиотеке Zotero
- добавить статью в библиотеку по DOI
- импортировать PDF и прочитать его полный текст
- вставить цитаты в документ Word
- переключаться между библиотеками Zotero

## Примеры запросов агенту
- Найди в моей библиотеке Zotero статьи по теме исследования.
- Добавь в Zotero статью с DOI `10.xxxx/example` и найди доступный PDF.
- Вставь в документ Word цитаты из выбранных записей Zotero.

## Похожие
- [Zotero MCP](https://affpapa.org/nevibecode/mcp/zotero-mcp.md) — MCP-сервер · ★ 5548
- [arxiv-mcp-server](https://affpapa.org/nevibecode/mcp/arxiv-mcp-server.md) — MCP-сервер · ★ 3231
- [PaperBanana](https://affpapa.org/nevibecode/mcp/paperbanana.md) — MCP-сервер · ★ 2417
- [MATLAB MCP Server](https://affpapa.org/nevibecode/mcp/matlab-mcp-server.md) — MCP-сервер · ★ 1716
- [Hex Research](https://affpapa.org/nevibecode/mcp/hex-research.md) — MCP-сервер · ★ 583
- [DocsAgent — Zotero, Obsidian & Apple Notes MCP Server](https://affpapa.org/nevibecode/mcp/docsagent-zotero-obsidian-apple-notes-mcp-server.md) — MCP-сервер · ★ 578

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md