anki-mcp/anki-mcp-desktop

Добавляет новое поле в существующий тип заметок Anki (модель). По умолчанию поле добавляется в конец, либо вставляется в конкретную позицию. У существующих заметок этого типа новое поле будет пустым. Используйте modelFieldNames, чтобы посмотреть текущие поля перед добавлением.

Добавьте ОДНУ заметку в Anki. Чтобы создать несколько заметок, используйте пакетный инструмент addNotes вместо многократного вызова addNote — AnkiConnect обрабатывает запросы по одному за раз, поэтому повторные (особенно параллельные) вызовы addNote работают медленнее и не нужны. Используйте modelNames, чтобы посмотреть доступные типы заметок, и modelFieldNames, чтобы узнать обязательные поля. В случае успеха возвращает ID заметки. ВАЖНО: создавайте только те заметки, которые явно запросил пользователь.

Добавляет несколько заметок в Anki одним пакетом — предпочтительный способ создания более одной заметки (используйте его вместо повторных вызовов addNote). До 100 заметок, использующих одну и ту же колоду и модель. Дубликаты пропускаются по отдельности; ошибки валидации (пустые обязательные поля, некорректные теги) отклоняют весь пакет. ВАЖНО: Создавайте только те заметки, которые явно запросил пользователь.

Добавляет теги к указанным заметкам. Теги задаются строкой, разделённой пробелами (например, "tag1 tag2 tag3"). Сначала используйте getTags, чтобы узнать существующие теги и избежать дублирования.

Перемещает карты в другую колоду. Целевая колода будет создана, если её не существует.

Удалите осиротевшие теги, которые не используются ни в одной заметке в коллекции. КРИТИЧНО: это разрушительно и необратимо, запускайте только когда пользователь явно запрашивает очистку тегов.

Получает агрегированную статистику по всем колодам коллекции, включая количество карт, распределение коэффициента лёгкости и распределение интервалов. Данные по каждой колоде суммируются с учётом дочерних колод (родительская колода включает дочерние), как в браузере колод Anki. На уровне коллекции `counts` суммирует только корневые колоды, чтобы избежать двойного учёта дочерних. Инвариант: для каждой колоды и для коллекции total === new + learning + review + other. Используйте это, чтобы проанализировать общее состояние коллекции и сравнить статистику колод. Корзины по лёгкости и корзины по интервалам можно настроить под конкретные диапазоны.

Создайте новую пустую колоду Anki. Используйте "::" для структуры родитель::потомок (максимум 2 уровня, например, "Japanese::JLPT N5"). Не перезаписывает существующие колоды.

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

Получает полную статистику для одной колоды, включая количество карт, распределение по лёгкости и интервалам. Укажите название колоды (например, "Japanese::JLPT N5") и необязательные границы корзин. Количество карт суммируется по всем дочерним колодам (родительские колоды включают свои дочерние), что соответствует браузеру колод Anki. Инвариант: total === new + learning + review + other.

Удаляет медиафайл из папки collection.media в Anki. КРИТИЧЕСКИ ВАЖНО: это действие необратимо и окончательно — удаляйте только те медиафайлы, которые пользователь явно подтвердил для удаления.

Удаляет заметки по их ID. Это навсегда удалит заметки и ВСЕ связанные с ними карточки. Это действие нельзя отменить, если у вас нет резервной копии. КРИТИЧЕСКИ ВАЖНО: это разрушительное и необратимое действие — удаляйте только те заметки, которые пользователь явно подтвердил для удаления.

Ищет заметки по синтаксису запросов Anki. Возвращает массив ID заметок, соответствующих запросу. Примеры: "deck:Spanish", "tag:verb", "is:due", "front:hello", "added:1" (карточки, добавленные сегодня), "prop:due<=2" (карточки, срок которых наступает в течение 2 дней), "flag:1" (красный флажок), "is:suspended"

Извлекает карточки из Anki с гибкой фильтрацией по колоде и состоянию карточки. ВАЖНО: Сначала используйте инструмент синхронизации СНАЧАЛА перед получением карточек, чтобы обеспечить актуальность данных. После получения карточек используйте present_card, чтобы показывать их пользователю по одной.

Извлеките карточки, запланированные для повторения из Anki. ВАЖНО: сначала используйте инструмент синхронизации sync tool, чтобы получить последние данные. После извлечения карточек используйте present_card, чтобы показывать их пользователю одну за другой.

Перечисляет медиафайлы в папке collection.media программы Anki, опционально отфильтрованные по шаблону в стиле glob.

Получите все теги в коллекции Anki. Используйте это, чтобы узнать существующие теги перед созданием заметок, чтобы поддерживать согласованность и предотвратить дублирование тегов (например, избегая 'roman-empire' vs 'roman_empire' vs 'RomanEmpire').

Открывает диалог Add Cards в Anki с предустановленными деталями заметки (колода, модель, поля, теги). Возвращает потенциальный ID заметки. ВАЖНО: Используйте только когда пользователь явно запрашивает открытие диалога Add Cards. Этот инструмент предназначен для рабочих процессов редактирования/создания заметок. Используйте его, когда пользователь хочет вручную просмотреть и завершить создание заметки в GUI.

Открывает Anki Card Browser и выполняет поиск карточек с использованием синтаксиса запросов Anki. Возвращает массив найденных идентификаторов карточек. ВАЖНО: Используйте только когда пользователь явно запрашивает открытие браузера. Этот инструмент предназначен для рабочих процессов редактирования/создания заметок, а НЕ для сеансов повторения. Используйте его для поиска и выбора карточек/заметок, которые требуют редактирования.

Получает информацию о текущей карточке, отображаемой в режиме повторения. Возвращает детали карточки (вопрос, ответ, колоду, модель и т.д.) или null, если не в режиме повторения. ВАЖНО: Этот инструмент предназначен ТОЛЬКО для рабочих процессов редактирования/создания заметок, когда пользователю нужно проверить, какая карточка сейчас отображается в GUI. НИКОГДА не используйте его для проведения сеансов повторения. Вместо этого используйте специальные инструменты для повторения (get_due_cards, present_card, rate_card). ВАЖНО: Используйте только тогда, когда пользователь явно запрашивает информацию о текущей карточке.

Открывает диалог Anki Deck Browser, отображающий все колоды. ВАЖНО: Используйте только тогда, когда пользователь явно запрашивает открытие deck browser. Этот инструмент предназначен для рабочих процессов управления и организации колод, а НЕ для сеансов повторения. Используйте это, когда пользователь хочет увидеть все колоды или управлять структурой колод.

Открывает диалог обзора колоды Anki для конкретной колоды. Показывает статистику колоды и параметры изучения. Возвращает true в случае успеха. ВАЖНО: Используйте только когда пользователь явно запрашивает открытие обзора колоды. Этот инструмент предназначен для управления колодами и организации заметок, НЕ для сеансов повторения.

Открывает диалог редактора заметок Anki для конкретного ID заметки. Позволяет вручную редактировать поля заметки, теги и карточки в графическом интерфейсе. ВАЖНО: Используйте только когда пользователь явно запрашивает редактирование заметки через GUI. Этот инструмент нужен для сценариев редактирования заметок, если пользователь хочет править вручную в интерфейсе Anki. Для программного редактирования используйте updateNoteFields.

Выбирает конкретную карточку в открытом окне Card Browser. Возвращает true, если браузер открыт и карточка выбрана, false — если браузер не открыт. ВАЖНО: используйте только когда пользователь явно просит выбрать карточку в браузере. Этот инструмент для рабочих процессов редактирования и создания заметок, а НЕ для сессий повторения. Card Browser уже должен быть открыт (сначала используйте guiBrowse).

Получает ID заметок, выбранных в данный момент в Card Browser. Возвращает массив ID заметок (пустой, если ничего не выбрано). ВАЖНО: Используйте только когда пользователь явно запрашивает получение выбранных заметок. Этот инструмент предназначен для рабочих процессов редактирования и создания заметок, а НЕ для сеансов повторения. Card Browser должен быть открыт, и карточки должны быть выбраны.

Показывает сторону ответа текущей карточки в режиме проверки. Возвращает true, если находитесь в режиме проверки, иначе false. КРИТИЧНО: Этот инструмент предназначен ТОЛЬКО для рабочих процессов создания/редактирования заметок, когда пользователю нужно увидеть сторону ответа, чтобы проверить содержимое. НИКОГДА не используйте его для проведения сеансов повторения. Вместо этого используйте специальные инструменты для повторения (present_card). ВАЖНО: Используйте только когда пользователь явно запрашивает показ ответа.

Показывает сторону вопроса текущей карточки в режиме обзора. Возвращает true, если вы в режиме обзора, и false в противном случае. КРИТИЧЕСКИ ВАЖНО: этот инструмент предназначен ТОЛЬКО для рабочих процессов редактирования или создания заметок, когда пользователю нужно увидеть сторону вопроса, чтобы проверить содержимое. НИКОГДА не используйте его для проведения сеансов обзора. Вместо этого используйте специальные инструменты для обзора (present_card). ВАЖНО: используйте только по явному запросу пользователя на показ вопроса.

Отменяет последнее действие или карточку в Anki. Возвращает true, если отмена удалась, иначе false. ВАЖНО: Используйте только когда пользователь явно запрашивает отмену действия. Этот инструмент предназначен для рабочих процессов создания/редактирования заметок, а НЕ для сессий повторения. Используйте его, чтобы отменить ошибки при создании заметок, редактировании или управлении карточками.

Вывести список всех колод Anki, опционально со статистикой количества карточек для каждой колоды. Не забудьте сначала синхронизироваться в начале сессии, чтобы получить актуальные данные.

Получите имена полей для конкретного типа заметок (модели). Используйте это, чтобы узнать, какие поля обязательны при создании заметок этого типа.

Получите список всех доступных названий типов заметок (моделей) в Anki. Используйте это, чтобы увидеть, какие типы заметок доступны перед созданием заметок.

Получите CSS-стили для конкретного типа заметки (модели). Этот CSS используется при рендеринге карточек этого типа.

Получить шаблоны карточек (HTML лицевой и обратной стороны) для конкретного типа заметок (модели). Возвращает HTML-содержимое лицевой и обратной сторон каждого шаблона карточки. Используйте это перед updateModelTemplates, чтобы увидеть текущие шаблоны и спланировать изменения.

Получает подробную информацию о конкретных заметках, включая все поля, теги, информацию о модели и CSS-стили. Используйте этот инструмент после findNotes, чтобы получить полные данные заметки. Включает CSS для корректного отображения.

Получить содержимое карточки для повторения. АЛГОРИТМ: 1) Показать вопрос, 2) Дождаться ответа пользователя, 3) Показать ответ с show_answer=true, 4) Оценить и предложить оценку (1-4), 5) Дождаться подтверждения пользователя ("ok"/"next" = принять, или пользователь указывает другую оценку), 6) Только после этого использовать rate_card

Отправьте оценку для карточки, чтобы обновить расписание интервальных повторений Anki. Используйте это ТОЛЬКО после того, как пользователь подтвердит или изменит вашу предложенную оценку. Не выставляйте оценку автоматически без ввода пользователя.

Удалить поле из существующего типа заметок Anki (модели). ВНИМАНИЕ: все данные, хранящиеся в этом поле во всех заметках данного типа, будут безвозвратно удалены. Используйте modelFieldNames, чтобы подтвердить имя поля перед удалением.

Удаляет теги из указанных заметок. Теги - это строка, разделённая пробелами (например, "tag1 tag2 tag3").

Переименовывает поле в существующем типе заметок Anki (модели). Шаблоны карточек, которые ссылаются на старое имя поля (например, {{OldName}}), нужно будет обновить отдельно с помощью updateModelTemplates — они не обновляются автоматически. Используйте modelFieldNames, чтобы подтвердить текущее имя поля перед переименованием.

Переименовать тег в указанных заметках (например, «RomanEmpire» -> «roman-empire»). Только один тег; пробелы запрещены в обоих значениях.

Изменяет положение поля в типе заметок Anki (модели). Поля нумеруются с 0: индекс 0 — первое поле. (Какое поле является полем сортировки — это отдельная настройка модели, и она не меняется при перестановке.) Используйте modelFieldNames, чтобы увидеть текущий порядок полей перед перестановкой.

Скачивает медиа-файл из папки collection.media в Anki. Возвращает содержимое файла в кодировке base64 или null, если файл не найден.

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

Загружает медиафайл в папку collection.media в Anki. Поддерживает base64 данные, абсолютные пути к файлам или URL. Идеально подходит для сценариев вроде ElevenLabs TTS -> аудиокарточки Anki.

Синхронизируйте локальную коллекцию Anki с AnkiWeb. ВАЖНО: Всегда синхронизируйте в НАЧАЛЕ сессии повторения (до получения карточек) и в КОНЦЕ, когда пользователь сообщит, что закончил. Это обеспечивает согласованность данных на разных устройствах.

Обновите CSS-стили существующего типа заметок (модели). Это меняет способ отображения карточек этого типа в Anki. Полезно для добавления поддержки RTL (справа налево), изменения шрифтов, цветов или расположения. Изменения применяются ко всем карточкам этой модели.

Обновляет шаблоны карточек (HTML лицевой и обратной сторон) для существующего типа заметок (модели). Каждый шаблон карточки определяет, как отображаются лицевая и обратная стороны карточки. Сначала используй modelTemplates, чтобы посмотреть текущие шаблоны, затем измени и передай обратно объект templates. Изменения применяются ко всем карточкам, использующим эту модель. ПРЕДУПРЕЖДЕНИЕ: некорректный HTML или отсутствие обязательных полей может сломать отображение карточек. Имена шаблонов проверяются по существующим шаблонам модели (с учётом регистра) — неизвестные или неправильно написанные имена отклоняются до применения изменений. Пустая строка не может использоваться для очистки стороны.

Обновляет поля существующей заметки. Поддерживает HTML-контент в полях и сохраняет CSS-стили. ВНИМАНИЕ: Не просматривайте заметку в браузере Anki во время обновления, иначе поля не обновятся корректно. Перед обновлением закройте браузер или переключитесь на другую заметку. ВАЖНО: Обновляйте только те заметки, которые пользователь явно попросил изменить.