# Zoteus

Подключает Zotero к Claude Code для поиска по библиотеке, работы с PDF и оформления ссылок. Пригодится, когда нужно собирать источники и цитаты прямо в чате.

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

## Что делает

Zoteus даёт агенту доступ к библиотеке Zotero: он ищет материалы по словам и смыслу, находит фрагменты в PDF с номерами страниц и оформляет библиографию в стилях CSL. По DOI или идентификатору arXiv можно добавить запись. Сервер также умеет создавать и редактировать элементы, ставить теги и перемещать записи в корзину с возможностью восстановления.

Когда приложение Zotero запущено, сервер обращается к библиотекам, которые оно содержит. Для синхронизации, библиотек групп вне приложения и работы при закрытом Zotero нужен ключ API. Без него эти сценарии не заработают. Zoteus написан на TypeScript; для Claude Code доступны удалённое подключение и локальный запуск через `npx`.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.zoteus.com/mcp`
- Переменные окружения: `ZOTERO_API_KEY`, `ZOTEUS_LOCAL`, `ZOTEUS_ALLOW_DELETE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http zoteus https://mcp.zoteus.com/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env ZOTERO_API_KEY=<ZOTERO_API_KEY> --env ZOTEUS_LOCAL=<ZOTEUS_LOCAL> --env ZOTEUS_ALLOW_DELETE=<ZOTEUS_ALLOW_DELETE> --transport stdio zoteus -- npx -y @oscardvs/zoteus
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add zoteus --url https://mcp.zoteus.com/mcp
```

2. **Командой платформы**
```bash
codex mcp add zoteus --env ZOTERO_API_KEY=<ZOTERO_API_KEY> --env ZOTEUS_LOCAL=<ZOTEUS_LOCAL> --env ZOTEUS_ALLOW_DELETE=<ZOTEUS_ALLOW_DELETE> -- npx -y @oscardvs/zoteus
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "zoteus": {
            "url": "https://mcp.zoteus.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "zoteus": {
            "command": "npx",
            "args": [
                "-y",
                "@oscardvs/zoteus"
            ],
            "env": {
                "ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
                "ZOTEUS_LOCAL": "<ZOTEUS_LOCAL>",
                "ZOTEUS_ALLOW_DELETE": "<ZOTEUS_ALLOW_DELETE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "zoteus": {
            "type": "http",
            "url": "https://mcp.zoteus.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "zoteus": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@oscardvs/zoteus"
            ],
            "env": {
                "ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
                "ZOTEUS_LOCAL": "<ZOTEUS_LOCAL>",
                "ZOTEUS_ALLOW_DELETE": "<ZOTEUS_ALLOW_DELETE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http zoteus https://mcp.zoteus.com/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e ZOTERO_API_KEY=<ZOTERO_API_KEY> -e ZOTEUS_LOCAL=<ZOTEUS_LOCAL> -e ZOTEUS_ALLOW_DELETE=<ZOTEUS_ALLOW_DELETE> zoteus npx -y @oscardvs/zoteus
```
Вместо <…> подставьте свои значения

## Когда брать
- найти статью по теме в библиотеке Zotero
- вытащить фрагмент из PDF вместе с номером страницы
- оформить список литературы в стиле CSL
- добавить статью по DOI или идентификатору arXiv
- отредактировать запись Zotero и переместить её в корзину

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

## Похожие
- [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