# Cite Caddy

Удалённый MCP-сервер с полным доступом к библиотеке Zotero: поиск, добавление, теги, коллекции, вложения и заметки. Пригодится, когда нужно автоматизировать работу со ссылками.

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

## Что делает

Cite Caddy подключается к Zotero через Web API и даёт ассистенту 39 инструментов: искать и добавлять записи, править поля, вешать теги, создавать и переименовывать коллекции, загружать вложения и читать их распознанный текст, работать с заметками, корзиной и сохранёнными поисками. Есть и запрос к схеме типов и полей самого Zotero.

Сервер поставляется отдельным Docker-контейнером и рассчитан на работу за обратным прокси с TLS: клиент просто указывает URL, локально ничего запускать не нужно. В режиме stdio библиотека задаётся переменными `ZOTERO_LIBRARY_ID`, `ZOTERO_LIBRARY_TYPE` и `ZOTERO_API_KEY`; ключ нужен с правом записи, а не только чтения. В HTTP-режиме каждый пользователь вводит свои данные через форму `/login`, а ключи арендаторов шифруются ключом `MCP_TOKEN_STORE_KEY`.

Осторожнее с удалением и переносом между библиотеками. Запись в Word через плагин Zotero ссылается на запись по её key, вшитому в поле кода, а перенос Zotero выполняет как удаление с последующим созданием заново. Такие операции ломают ссылки молча: документ не выдаст ошибку, просто покажет устаревший текст поля при следующем обновлении. Операции, сохраняющие key, безопасны. Для шести разрушительных вызовов, включая `delete_item_permanently` и `move_item_to_different_library`, можно передать необязательный `idempotency_key` — повтор при потерянном ответе вернёт прежний результат вместо нового запуска. Кэш живёт в памяти процесса 24 часа и не переживает перезапуск.

## Требования
- Нужно: Docker
- Удалённый сервер: `https://citecaddy.herbertkokholm.dk/mcp`

## Установка

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

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http cite-caddy https://citecaddy.herbertkokholm.dk/mcp
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add cite-caddy --url https://citecaddy.herbertkokholm.dk/mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cite-caddy": {
            "url": "https://citecaddy.herbertkokholm.dk/mcp"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "cite-caddy": {
            "type": "http",
            "url": "https://citecaddy.herbertkokholm.dk/mcp"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http cite-caddy https://citecaddy.herbertkokholm.dk/mcp
```

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

## Примеры запросов агенту
- Найди в Zotero все записи с DOI из файла `refs.txt` и добавь им тег `to-read`
- Создай коллекцию «Обзор 2025» и перенеси туда записи по теме графовых нейросетей
- Покажи заметки к записи с ключом `ABCD1234`

## Похожие
- [Zotero Native MCP](https://affpapa.org/nevibecode/mcp/zotero-native-mcp.md) — MCP-сервер · ★ 11
- [cnki-export](https://affpapa.org/nevibecode/skills/cnki-export.md) — скилл · 412 установок
- [Obsidian Vault MCP](https://affpapa.org/nevibecode/mcp/obsidian-vault-mcp.md) — MCP-сервер · ★ 94
- [research-ideation](https://affpapa.org/nevibecode/skills/galaxy-dawn-research-ideation.md) — скилл · 566 установок
- [zotero-obsidian-bridge](https://affpapa.org/nevibecode/skills/zotero-obsidian-bridge.md) — скилл · 473 установки
- [Paper Distill MCP](https://affpapa.org/nevibecode/mcp/paper-distill-mcp.md) — MCP-сервер · ★ 68

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