🧠 Анки МКП

Трансформируйте свой опыт работы с карточками Anki с помощью ИИ! Этот сервер MCP (Model Context Protocol) связывает вашу коллекцию карточек Anki с помощниками ИИ, такими как Клод, позволяя вести естественные беседы о ваших учебных материалах.

🚀 Что вы можете сделать?

Представьте себе, что у вас есть наставник на основе искусственного интеллекта, который знает всю вашу коллекцию карточек и может:

📚 Интерактивное обучение

• «Проверь меня на знание японской лексики, которую я не видел 3 дня»

• «Проверьте меня на сложных картах из моей медицинской колоды»

• «Покажите мне карты, с которыми у меня в последнее время возникли трудности»

✨ Создание интеллектуального контента

• «Создание карточек по теме фотосинтеза с диаграммами»

• «Превратите эту главу PDF в карточки для повторения с интервалами»

• «Создать карточки удаления из моих лекционных записей»

🔍 Мощная аналитика

• «С какими темами у меня больше всего проблем?»

• «Покажи мне мои учебные планы за последний месяц»

• «Каков мой процент удержания для разных типов карт?»

🎯 Массовые операции

• «Пометьте все мои карточки по химии как «подготовка к экзамену»»

• «Переместите карточки с низким уровнем запоминания в колоду для интенсивного обзора»

• «Найти и исправить дубликаты карт в моих колодах»

🎯 Особенности

• Полная интеграция с Anki : полный доступ к колодам, картам, заметкам и статистике через все 115 методов API AnkiConnect

• Разговорный интерфейс : команды на естественном языке через вашего помощника на основе искусственного интеллекта

• Массовые операции : эффективное управление тысячами карт одновременно

• Статистика в реальном времени : получайте информацию о ходе вашего обучения

• Поддержка мультимедиа : обработка изображений, аудио и других медиафайлов на ваших карточках.

• Расширенные запросы : найдите карты, используя сложные критерии поиска

• Безопасность типов : полностью типизированный API с комплексной обработкой ошибок

🛠 Технический стек

• Node.js : среда выполнения (требуется 18+)

• TypeScript : безопасность типов и опыт разработчика

• MCP SDK : реализация протокола контекста модели

• yanki-connect : 🙏 Полностью типизированный, изоморфный API-клиент AnkiConnect

• tsup : Быстрый упаковщик TypeScript

• PNPM : Эффективный менеджер пакетов

Особая благодарность библиотеке

📋 Предварительные условия

1. Установите Anki

Загрузите и установите Anki, если вы еще этого не сделали.

2. Установите плагин AnkiConnect

1. Открыть Анки

2. Перейдите в Инструменты → Дополнения.

3. Нажмите «Получить дополнения»...

4. Введите код: 2055492159

5. Перезапустить Анки

📋 Требования к версии: Для полной совместимости этому серверу требуется AnkiConnect версии 25.2.25.0 или более новой (выпущенной 2025-02-25). Большинство функций работают и со старыми версиями, но мы рекомендуем обновиться для лучшего опыта.

3. Настройте AnkiConnect (необязательно)

AnkiConnect работает «из коробки», но вы можете настроить параметры:

1. Перейдите в Инструменты → Дополнения.

2. Выберите AnkiConnect и нажмите «Конфигурация».

3. Настройки по умолчанию должны подойти большинству пользователей.

🚀 Быстрый старт

Вариант 1: использование с Claude Desktop (рекомендуется)

1. Установить пакет

   npm install -g @arielbk/anki-mcp

2. Настроить рабочий стол Клода

   Отредактируйте файл конфигурации Claude Desktop:

   macOS : ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows : %APPDATA%\Claude\claude_desktop_config.json

   Добавьте эту конфигурацию:

   { "mcpServers": { "anki": { "command": "anki-mcp", "args": [] } } }

3. Перезагрузить рабочий стол Клода

4. Начните использовать его!

   • Убедитесь, что Anki запущена с включенным AnkiConnect.

   • Спросите Клода: «Покажи мне мои колоды Anki» или «Проверь меня с помощью 5 карт»

💡 Совет от профессионалов: вы можете проверить свою настройку, задавая Клоду простые вопросы, например : «Сколько у меня колод Anki?» или «Что в моей самой большой колоде?»

Вариант 2: Настройка разработки

1. Клонировать репозиторий

   git clone https://github.com/arielbk/anki-mcp.git cd anki-mcp

2. Установить зависимости

   pnpm install

3. Построить проект

   pnpm build

4. Протестируйте сервер

   # Use the MCP inspector to test functionality pnpm inspect

Вариант 3: использование с другими клиентами MCP

Этот сервер работает с любым MCP-совместимым клиентом. Вы также можете использовать его с:

• MCP Inspector : интерактивный инструмент отладки

• Cline : расширение VS Code для кодирования ИИ

• Пользовательские клиенты MCP : создайте свои собственные клиенты с помощью MCP SDK

Для stdio-транспорта выполните:

🎮 Примеры использования

После настройки Claude Desktop вы сможете вести естественные беседы, например:

📖 Учебные сессии

📝 Создание контента

📊 Аналитика исследования

🏷️ Организация

🔧 Доступные инструменты и ресурсы

Этот сервер MCP обеспечивает полный доступ к вашей коллекции Anki с помощью следующих возможностей:

📚 Управление палубой

• Список всех колод со статистикой

• Создавайте новые колоды

• Переименовывать и удалять колоды

• Получить конфигурацию колоды

🗂️ Операции с картами

• Найти карты по критериям поиска

• Карточки с ответами (имитация обзоров)

• Получить информацию о карте и статистику

• Приостановить/разблокировать карты

• Массовые операции с картами

📝 Управление заметками

• Добавляйте новые заметки с пользовательскими полями

• Обновить существующие заметки

• Удалить заметки

• Найти заметки по поисковому запросу

• Массовые операции с банкнотами

📊 Статистика и аналитика

• Статистика колоды и показатели производительности

• Данные об удобстве и интервалах карт

• Обзор истории и закономерностей

• Анализ прогресса обучения

🎨 Медиа и модели

• Доступ к типам заметок и определениям полей

• Управление медиафайлами

• Поддержка настройки шаблона

🔍 Расширенные функции

• Сложные поисковые запросы с использованием синтаксиса поиска Anki

• Пакетные операции для эффективности

• Синхронизация в реальном времени с Anki

• Обработка ошибок и проверка

• Организованные методы API, сгруппированные по функциональности (карты, колоды, заметки, модели, статистика, медиа и т. д.)

• Прямой доступ ко всем 115 методам API AnkiConnect с полной безопасностью типов

🛠 Развитие

🔧 Конфигурация

Настройки AnkiConnect

По умолчанию сервер подключается к AnkiConnect на localhost:8765 . Если вы настроили конфигурацию AnkiConnect, вам может потребоваться изменить настройки подключения.

Важно : убедитесь, что Anki запущена и AnkiConnect установлен перед использованием сервера MCP. Сервер не сможет подключиться, если AnkiConnect недоступен.

💡 Примечание: Базовая библиотека yanki-connect поддерживает автоматический запуск Anki на macOS, но эта функция в настоящее время не представлена в конфигурации сервера MCP. Вам нужно будет запустить Anki вручную.

Расширенная конфигурация рабочего стола Claude

Для опытных пользователей можно передать дополнительные параметры:

Поиск неисправностей

Распространенные проблемы:

• «Не удалось подключиться к AnkiConnect» : убедитесь, что Anki запущен и установлен плагин AnkiConnect.

• «Колоды не найдены» : убедитесь, что у вас есть хотя бы одна колода в Anki

• Клод не отвечает : перезапустите Claude Desktop после изменения конфигурации.

• Ошибки разрешений : проверьте, что глобальная установка npm работает правильно с помощью npm list -g @arielbk/anki-mcp

🤝 Вклад

Мы приветствуем ваши вклады! Пожалуйста:

1. Форк репозитория

2. Создать ветку функций

3. Внесите изменения

4. Добавьте тесты, если применимо

5. Отправить запрос на извлечение

📜 Лицензия

MIT — подробности см. в файле LICENSE .

🙏 Благодарности

• yanki-connect — превосходный клиент TypeScript для AnkiConnect

• AnkiConnect — плагин, делающий возможной автоматизацию Anki

• Протокол контекста модели — обеспечение бесшовной интеграции ИИ

Измените свой опыт работы с карточками с помощью бесед на основе искусственного интеллекта! 🚀