anki-mcp/anki-mcp-desktop

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

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

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

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

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

Удаляет осиротевшие теги, которые не используются ни в одной заметке коллекции. ВАЖНО: это действие необратимо и окончательно - запускайте только по прямому запросу пользователя на очистку тегов.

Получает агрегированную статистику по всем колодам коллекции: количество карт, распределение по фактору лёгкости и распределение по интервалам. Возвращает ДВА разных представления, не путайте их: counts и per_deck — это сегодняшняя очередь на изучение, как в списке колод Anki (карты ДОЛЖНЫ БЫТЬ ПОВТОРЕНЫ СЕГОДНЯ, ограниченные дневным лимитом новых/повторов каждой колоды, отложенные/закопанные исключены); states — истинное количество карт в каждом состоянии (новые / в изучении / на повторении / отложенные / закопанные) по всей коллекции, без учёта дат повторения и дневных лимитов. Чтобы ответить на вопрос «сколько у меня карт», используйте states; чтобы ответить «что я буду учить сегодня», используйте counts. Поколодные счётчики суммируются по потомкам (родительская колода включает дочерние); счётчики на уровне коллекции counts суммируют ТОЛЬКО корневые колоды, чтобы избежать двойного учёта дочерних. states — только на уровне коллекции (каждый вызов требует 5 дополнительных поисков в Anki) — для истинных счётчиков состояний отдельной колоды используйте инструмент deckStats. Для каждой колоды и для коллекции: обычно total === new + learning + review + other; other ограничено нулём, поэтому в редких случаях (фильтрованные колоды / унаследованные лимиты) сумма может превышать total. Группы лёгкости и группы интервалов можно настраивать, чтобы сфокусироваться на конкретных диапазонах.

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

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

Получает полную статистику для одной колоды, включая количество карт, распределение лёгкости и интервалов. Передайте название колоды (например, "Japanese::JLPT N5") и необязательные границы интервалов. Возвращает ДВА разных представления, не путайте их: counts - это сегодняшняя очередь изучения, как показано в браузере колод Anki (карты, ПОДЛЕЖАЩИЕ ПОВТОРЕНИЮ СЕГОДНЯ, ограниченные ежедневными лимитами новых/повторяемых карт колоды, исключая отложенные и закопанные); states - это истинное количество карт в каждом состоянии (новые / в изучении / на повторении / отложенные / закопанные), без учёта дат повторения и ежедневных лимитов. Чтобы ответить на вопрос "сколько у меня карт", используйте states; чтобы ответить на вопрос "что я буду учить сегодня", используйте counts. Оба представления агрегируют данные по дочерним колодам (родительские колоды включают свои дочерние). states требует 5 дополнительных поисков в Anki за один вызов. Для counts: обычно total === new + learning + review + other; other ограничен нулём, поэтому в редких случаях с фильтрованными колодами или унаследованными лимитами сумма может превышать total.

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

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

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

Reset cards to the new queue, discarding their current scheduling (interval, due date, and ease factor). Use this when a card should be relearned from scratch — for example when the user keeps failing to recall a word that Anki has scheduled months out. Prefer this over rating a card 'Again': a rating records a real review and counts as a lapse, which distorts both future scheduling and the collection's statistics. The review log is preserved, so past reviews still show in card info and statistics. This changes scheduling only — note content, tags, and deck placement are untouched. Cards that are already new are unaffected, so re-running is safe.

Retrieve cards from Anki with flexible filtering by deck and card state. IMPORTANT: Use sync tool FIRST before getting cards to ensure latest data. By default answers are NOT included (include_answer defaults to false) so they never enter context before the user has a chance to self-test — after getting cards, use present_card to show them one by one and reveal the answer only when the user is ready. Set include_answer=true only for content analysis/editing workflows that are not live review sessions.

Retrieve cards that are due for review from Anki. IMPORTANT: Use sync tool FIRST before getting cards to ensure latest data. By default answers are NOT included (include_answer defaults to false) so they never enter context before the user has a chance to self-test — after getting cards, use present_card to show them one by one and reveal the answer only when the user is ready. Set include_answer=true only for content analysis/editing workflows that are not live review sessions.

Перечисляет медиафайлы в папке 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 — карты, ОЖИДАЮЩИЕ СЕГОДНЯ, ограниченные дневными лимитами новых/повторных карт каждой колоды, без учёта отложенных и скрытых карт — НЕ общее количество по состоянию карт. Используйте инструмент deckStats (его блок states) или collection_stats для получения настоящего количества по состоянию карт. Не забудьте сначала выполнить синхронизацию в начале сеанса для получения последних данных.

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

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

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

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

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

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

Submit a rating for a card to update Anki's spaced repetition scheduling. Before calling this, the card's answer must already have been revealed to the user via present_card with show_answer: true, and the user must have self-assessed their recall. Use this ONLY after the user confirms or modifies your suggested rating. Do not rate automatically without user input.

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

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

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

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

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

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

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

Reschedule cards to become due in a given number of days, without recording a review. Use this to bring a card forward (or push it back) when its current interval doesn't match how well the user actually knows it — rating the card instead would log a fake review and skew its ease factor. Unlike forgetCards this keeps the card's existing interval and ease unless you ask otherwise, so it is the gentler option when the card's history is still worth keeping. Note that applying this to a new card turns it into a review card.

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

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

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

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

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