Zotero Native MCP — MCP-сервер для Claude Code: настройка
Подключает ИИ-ассистента к локальной библиотеке Zotero 10 без облачных сервисов и сторонних расширений. Управляет библиографией, находит статьи и прикрепляет файлы PDF.
claude mcp add --env ZOTERO_LOCAL_PORT=<ZOTERO_LOCAL_PORT> --env ZOTERO_LOCAL_APP_NAME=<ZOTERO_LOCAL_APP_NAME> --transport stdio zotero-native-mcp -- npx -y zotero-native-mcpЧто делает Zotero Native MCP
Инструмент связывается с локальным API Zotero по адресу 127.0.0.1. Сеть не задействуется. За счёт прямого обращения отклики чтения укладываются в диапазон 8–60 мс. В арсенале сервера 28 функций, готовых к работе с личными и групповыми библиотеками.
Ассистент умеет искать источники по тексту вложенных PDF, создавать коллекции и назначать теги. Удаление по умолчанию переносит элементы в корзину Zotero. Но флаг permanent: true и команда очистки стирают файлы с диска безвозвратно. Сохраните резервную копию папки с базой zotero.sqlite перед запуском.
Сервер требует запущенный Zotero версии 10 или выше. На старых выпусках запись не сработает. Также понадобится Node.js 22 или новее. В расширенных настройках Zotero обязательно включите разрешение на связь с другими программами.
Какие задачи решает
- Привязать скачанные PDF к карточкам статей в каталоге
- Найти нужные цитаты по полному тексту локальных документов
- Разложить научные публикации по тематическим коллекциям
- Пакетно переименовать или очистить теги записей
Примеры запросов агенту
- Вызови zotero_status, чтобы проверить связь с запущенным приложением
- Найди в локальной библиотеке Zotero статьи по машинному обучению и покажи аннотации
- Создай в Zotero коллекцию Обзор методов и добавь туда последние открытые документы
Как установить Zotero Native MCP
Командой платформы
claude mcp add --env ZOTERO_LOCAL_PORT=<ZOTERO_LOCAL_PORT> --env ZOTERO_LOCAL_APP_NAME=<ZOTERO_LOCAL_APP_NAME> --transport stdio zotero-native-mcp -- npx -y zotero-native-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add zotero-native-mcp --env ZOTERO_LOCAL_PORT=<ZOTERO_LOCAL_PORT> --env ZOTERO_LOCAL_APP_NAME=<ZOTERO_LOCAL_APP_NAME> -- npx -y zotero-native-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"zotero-native-mcp": {
"command": "npx",
"args": [
"-y",
"zotero-native-mcp"
],
"env": {
"ZOTERO_LOCAL_PORT": "<ZOTERO_LOCAL_PORT>",
"ZOTERO_LOCAL_APP_NAME": "<ZOTERO_LOCAL_APP_NAME>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"zotero-native-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"zotero-native-mcp"
],
"env": {
"ZOTERO_LOCAL_PORT": "<ZOTERO_LOCAL_PORT>",
"ZOTERO_LOCAL_APP_NAME": "<ZOTERO_LOCAL_APP_NAME>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ZOTERO_LOCAL_PORT=<ZOTERO_LOCAL_PORT> -e ZOTERO_LOCAL_APP_NAME=<ZOTERO_LOCAL_APP_NAME> zotero-native-mcp npx -y zotero-native-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Zotero Native MCP
Как установить Zotero Native MCP в Claude Code?
Выполните команду claude mcp add zotero-native-mcp -- npx -y zotero-native-mcp. Инструменты активируются в сессии при запущенном Zotero.
Зачем нужен Zotero Native MCP?
Он открывает моделям прямой доступ к локальной библиографической базе на компьютере. Для его работы не требуются ключи zotero.org, плагины .xpi или облачная синхронизация.
Почему сервер требует Zotero 10?
Локальное API для изменения данных появилось только в десятой версии Zotero. На выпусках с 7 по 9 работают исключительно операции чтения, а запись вызывает ошибку.
