anki-mcp

Тонкий адаптер Model Context Protocol (MCP), который позволяет ИИ-ассистентам (Claude Code, Hermes Agent и т.д.) создавать и управлять карточками Anki напрямую — через AnkiConnect.

Никакого специального ИИ-приложения. ИИ остаётся интеллектуальным слоем; этот сервер — просто мост к Anki.

Claude Code / Hermes / ChatGPT
          │  MCP (stdio)
          ▼
    anki-mcp server
          │  AnkiConnect HTTP (localhost:8765)
          ▼
    Anki Desktop + AnkiConnect add-on
          │  sync
          ▼
       AnkiWeb ──► Anki mobile (iOS/Android)

Возможности

Related MCP server: Anki MCP Server

Установка

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

Скачайте и установите с https://apps.ankiweb.net/. Запустите его один раз и синхронизируйте с вашей учётной записью AnkiWeb, чтобы работала мобильная синхронизация.

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

AnkiConnect предоставляет доступ к Anki через локальный HTTP API на localhost:8765.

Вариант A — браузер дополнений Anki (самый простой):

1. В Anki: Инструменты → Дополнения → Получить дополнения…

2. Введите код 2055492159 и установите.

Вариант Б — вручную (Git):

cd "$APPDATA/Anki2/addons21"           # Windows
# or: ~/.local/share/Anki2/addons21   (Linux)
# or: ~/Library/Application Support/Anki2/addons21  (macOS)

git clone --depth 1 https://github.com/FooSoft/anki-connect.git 2055492159
cd 2055492159
cp plugin/*.py plugin/*.json plugin/*.md .
rm -rf plugin tests .git 2>/dev/null

3. Перезапустите Anki. Убедитесь, что он работает:

curl -s http://127.0.0.1:8765 -X POST -d '{"action":"version","version":6}'
# → {"result": 6, "error": null}

3. Запустите MCP-сервер

pip install mcp
python server.py

Сервер общается по MCP через stdio. Для работы инструментов Anki Desktop должен быть запущен (с загруженным AnkiConnect).

Настройка в клиенте

Hermes Agent

Добавьте в ~/.hermes/config.yaml (или %USERPROFILE%\AppData\Local\hermes\config.yaml в Windows):

mcp_servers:
  anki:
    command: python
    args:
      - /absolute/path/to/server.py
    timeout: 60
    connect_timeout: 30

Затем перезагрузите MCP в сессии (/reload-mcp) или перезапустите. Инструменты появятся как mcp_anki_*.

Claude Code

claude mcp add anki -- python /absolute/path/to/server.py

Использование

После подключения просто скажите ИИ, что вам нужно:

«Добавь карточку в мою колоду System Design: вопрос = „Почему консистентное хеширование использует виртуальные узлы?“, ответ = „Чтобы более равномерно распределять ключи.“»

«Создай карточки Anki из важных концепций, которые мы только что обсудили.»

Правила создания карточек (включите их в инструкции для ИИ)

• Одна концепция на карточку.

• Предпочитайте вопросы, требующие воспроизведения по памяти.

• Избегайте огромных ответов.

• Не создавайте карточки для тривиальных фактов.

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

• Добавляйте теги источника/темы.

Синхронизация с мобильным устройством

Карточки, созданные через MCP, хранятся в Anki Desktop до синхронизации. Запустите синхронизацию:

• Вручную: Anki → Синхронизировать (или нажмите Y), или

• Через AnkiConnect: curl -s http://127.0.0.1:8765 -X POST -d '{"action":"sync","version":6}'

Затем синхронизируйте мобильное приложение Anki, чтобы получить новые карточки.

Требования

• Python 3.10+

• пакет mcp (pip install mcp)

• Anki Desktop (запущенный)

• дополнение AnkiConnect

Лицензия

MIT