🧠 Анки МКП

Пакет NPM yanki-connect Лицензия: Массачусетский технологический институт

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

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

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

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

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

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

«Создание карточек по теме фотосинтеза с диаграммами»
«Превратите эту главу PDF в карточки для повторения с интервалами»
«Создать карточки удаления из моих лекционных записей»

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

«С какими темами у меня больше всего проблем?»
«Покажи мне мои учебные планы за последний месяц»
«Каков мой процент удержания для разных типов карт?»

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

«Пометьте все мои карточки по химии как «подготовка к экзамену»»
«Переместите карточки с низким уровнем запоминания в колоду для интенсивного обзора»
«Найти и исправить дубликаты карт в моих колодах»

Related MCP server: Maya MCP

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

Полная интеграция с Anki : полный доступ к колодам, картам, заметкам и статистике через все 115 методов API AnkiConnect
Разговорный интерфейс : команды на естественном языке через вашего помощника на основе искусственного интеллекта
Массовые операции : эффективное управление тысячами карт одновременно
Статистика в реальном времени : получайте информацию о ходе вашего обучения
Поддержка мультимедиа : обработка изображений, аудио и других медиафайлов на ваших карточках.
Расширенные запросы : найдите карты, используя сложные критерии поиска
Безопасность типов : полностью типизированный API с комплексной обработкой ошибок

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

Node.js : среда выполнения (требуется 18+)
TypeScript : безопасность типов и опыт разработчика
MCP SDK : реализация протокола контекста модели
yanki-connect : 🙏 Полностью типизированный, изоморфный API-клиент AnkiConnect
tsup : Быстрый упаковщик TypeScript
PNPM : Эффективный менеджер пакетов

Особая благодарность библиотеке yanki-connect за предоставление надежного интерфейса AnkiConnect, обеспечивающего эту интеграцию!

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

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

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

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

Открыть Анки
Перейдите в Инструменты → Дополнения.
Нажмите «Получить дополнения»...
Введите код: 2055492159
Перезапустить Анки

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

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

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

Перейдите в Инструменты → Дополнения.
Выберите AnkiConnect и нажмите «Конфигурация».
Настройки по умолчанию должны подойти большинству пользователей.

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

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

Установить пакет
```
npm install -g @arielbk/anki-mcp
```
Настроить рабочий стол Клода
Отредактируйте файл конфигурации Claude Desktop:
macOS : ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows : %APPDATA%\Claude\claude_desktop_config.json
Добавьте эту конфигурацию:
```
{
  "mcpServers": {
    "anki": {
      "command": "anki-mcp",
      "args": []
    }
  }
}
```
Перезагрузить рабочий стол Клода
Начните использовать его!
- Убедитесь, что Anki запущена с включенным AnkiConnect.
- Спросите Клода: «Покажи мне мои колоды Anki» или «Проверь меня с помощью 5 карт»

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

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

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

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

Установить зависимости
```
pnpm install
```
Построить проект
```
pnpm build
```

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

# Use the MCP inspector to test functionality
pnpm inspect

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

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

MCP Inspector : интерактивный инструмент отладки
Cline : расширение VS Code для кодирования ИИ
Пользовательские клиенты MCP : создайте свои собственные клиенты с помощью MCP SDK

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

node dist/index.js

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

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

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

You: "I have a Japanese exam tomorrow. Can you quiz me on Hiragana cards I haven't reviewed in a week?"

Claude: I'll find your Hiragana cards that need review and start a quiz session...

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

You: "Create flashcards for the major battles of World War II with dates and significance"

Claude: I'll create comprehensive flashcards covering the key WWII battles...

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

You: "How am I doing with my medical terminology deck? Show me my weak areas."

Claude: Let me analyze your performance on the medical terminology deck...

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

You: "Tag all cards about cardiovascular system with 'cardiology' and move them to my MCAT prep deck"

Claude: I'll help you organize those cards...

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

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

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

Список всех колод со статистикой
Создавайте новые колоды
Переименовывать и удалять колоды
Получить конфигурацию колоды

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

Найти карты по критериям поиска
Карточки с ответами (имитация обзоров)
Получить информацию о карте и статистику
Приостановить/разблокировать карты
Массовые операции с картами

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

Добавляйте новые заметки с пользовательскими полями
Обновить существующие заметки
Удалить заметки
Найти заметки по поисковому запросу
Массовые операции с банкнотами

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

Статистика колоды и показатели производительности
Данные об удобстве и интервалах карт
Обзор истории и закономерностей
Анализ прогресса обучения

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

Доступ к типам заметок и определениям полей
Управление медиафайлами
Поддержка настройки шаблона

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

Сложные поисковые запросы с использованием синтаксиса поиска Anki
Пакетные операции для эффективности
Синхронизация в реальном времени с Anki
Обработка ошибок и проверка
Организованные методы API, сгруппированные по функциональности (карты, колоды, заметки, модели, статистика, медиа и т. д.)
Прямой доступ ко всем 115 методам API AnkiConnect с полной безопасностью типов

🛠 Развитие

# Run in development mode with auto-reloading
pnpm dev

# Lint the code
pnpm lint

# Format the code
pnpm format

# Test with MCP inspector
pnpm inspect

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

Настройки AnkiConnect

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

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

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

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

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

{
  "mcpServers": {
    "anki": {
      "command": "anki-mcp",
      "args": ["--verbose"],
      "env": {
        "ANKI_CONNECT_HOST": "localhost",
        "ANKI_CONNECT_PORT": "8765"
      }
    }
  }
}

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

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

«Не удалось подключиться к AnkiConnect» : убедитесь, что Anki запущен и установлен плагин AnkiConnect.
«Колоды не найдены» : убедитесь, что у вас есть хотя бы одна колода в Anki
Клод не отвечает : перезапустите Claude Desktop после изменения конфигурации.
Ошибки разрешений : проверьте, что глобальная установка npm работает правильно с помощью npm list -g @arielbk/anki-mcp

🤝 Вклад

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

Форк репозитория
Создать ветку функций
Внесите изменения
Добавьте тесты, если применимо
Отправить запрос на извлечение

📜 Лицензия

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

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

yanki-connect — превосходный клиент TypeScript для AnkiConnect
AnkiConnect — плагин, делающий возможной автоматизацию Anki
Протокол контекста модели — обеспечение бесшовной интеграции ИИ

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