Anki MCP Server

Сервер протокола контекста модели (MCP), который позволяет LLM взаимодействовать с программным обеспечением для создания карточек Anki через AnkiConnect.

Возможности

Инструменты

• list_decks - Список всех доступных колод Anki

• create_deck - Создание новой колоды Anki

• create_note - Создание новой заметки (Basic или Cloze)

• batch_create_notes - Создание нескольких заметок одновременно

• search_notes - Поиск заметок с использованием синтаксиса запросов Anki

• get_note_info - Получение подробной информации о заметке

• update_note - Обновление существующей заметки

• delete_note - Удаление заметки

• list_note_types - Список всех доступных типов заметок

• create_note_type - Создание нового типа заметки

• get_note_type_info - Получение подробной структуры типа заметки

Ресурсы

• anki://decks/all - Полный список доступных колод

• anki://note-types/all - Список всех доступных типов заметок

• anki://note-types/all-with-schemas - Подробная информация о структуре всех типов заметок

• anki://note-types/{modelName} - Подробная информация о структуре конкретного типа заметки

Related MCP server: Anki MCP Server

Предварительные требования

1. Anki, установленный в вашей системе

2. Дополнение AnkiConnect, установленное в Anki

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

Установка через расширение для рабочего стола (.mcpb)

Этот репозиторий поддерживает расширения Anthropic Desktop (MCPB). Самый простой способ использовать этот сервер в Claude Desktop — установить упакованный пакет .mcpb.

1. Создайте файл .mcpb локально с помощью предоставленного скрипта:

npm run pack

2. Откройте настройки Claude Desktop → Расширения, перетащите созданный файл .mcpb и нажмите «Установить».

Это проверяет manifest.json и создает архив .mcpb, который можно установить, как описано выше. Узнайте больше о расширениях для рабочего стола в анонсе Anthropic: Desktop Extensions: One-click MCP server installation for Claude Desktop.

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

Добавьте сервер в ваш файл claude_desktop_config.json:

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

Использование пользовательского порта AnkiConnect

Если ваш AnkiConnect работает на другом порту, вы можете указать его с помощью параметра --port:

{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes", "anki-mcp-server", "--port", "8080"]
    }
  }
}

Конфигурация для Cline

Добавьте сервер в файл настроек Cline MCP внутри настроек VSCode cline_mcp_settings.json

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

Использование пользовательского порта AnkiConnect

Для Cline вы также можете указать пользовательский порт:

{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes", "anki-mcp-server", "--port", "8080"]
    }
  }
}

Навыки агента (Claude Code)

Установите навык Anki, чтобы дать Claude Code встроенные знания обо всех инструментах и рабочих процессах Anki:

npx skills add nailuoGG/anki-mcp-server@anki

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

Примечание: Не используйте упакованную версию .mcpb в качестве MCP-сервера — она выводит метаданные Electron в stdout, что нарушает протокол MCP stdio. Вместо этого используйте npx -y anki-mcp-server.

Разработка

Упаковка расширения для рабочего стола (.mcpb)

Создайте дистрибутивный пакет расширения для рабочего стола для Claude Desktop:

npm run pack

Это соберет проект и создаст архив .mcpb из текущего репозитория, проверив manifest.json. Протестируйте его, перетащив в настройки расширений Claude Desktop. Ссылка: Desktop Extensions: One-click MCP server installation for Claude Desktop.

Публикация в реестре MCP

Этот сервер автоматически публикуется в реестре MCP при выпуске новой версии. Процесс публикации включает:

1. Автоматизированный CI/CD: GitHub Actions автоматически публикует пакеты в NPM и реестр MCP при успешных релизах

2. Валидация схемы: Файл server.json проверяется на соответствие схеме MCP перед публикацией

3. Синхронизация версий: Версии синхронизируются между package.json, manifest.json и server.json

4. Комплексное тестирование: Тестирование на нескольких версиях Node.js, линтинг и проверка перед публикацией

5. Бета-поддержка: Автоматизированные бета-релизы для тестирования новых функций

Ручная проверка

Вы можете проверить конфигурацию MCP-сервера локально:

npm run validate-mcp

Это загрузит последнюю схему MCP и проверит ваш файл server.json.

Ручная публикация

Если вам нужно опубликовать вручную, вы можете использовать CLI издателя MCP:

# Install MCP Publisher
curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.1.0/mcp-publisher_1.1.0_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
chmod +x mcp-publisher
sudo mv mcp-publisher /usr/local/bin/

# Login to MCP Registry
mcp-publisher login github-oidc

# Publish to MCP Registry
mcp-publisher publish

Настройка

1. Установите зависимости:

npm install

2. Соберите сервер:

npm run build

3. Для разработки с автоматической пересборкой:

npm run watch

Тестирование

Запустите набор тестов:

npm test

Это выполняет тесты для:

• Инициализации сервера

• Связи с AnkiConnect

• Операций с заметками (создание/чтение/обновление/удаление)

• Управления колодами

• Обработки ошибок

Отладка

Поскольку MCP-серверы общаются через stdio, мы рекомендуем использовать MCP Inspector:

npm run inspector

Он предоставляет интерфейс на основе браузера для:

• Мониторинга сообщений MCP

• Тестирования вызовов инструментов

• Просмотра журналов сервера

• Отладки проблем со связью

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

1. Создайте новую колоду:

Create a new Anki deck called "Programming"

2. Добавьте базовую карточку:

Create an Anki card in the "Programming" deck with:
Front: What is a closure in JavaScript?
Back: A closure is the combination of a function and the lexical environment within which that function was declared.

3. Добавьте карточку с пропуском (cloze deletion):

Create a cloze card in the "Programming" deck with:
Text: In JavaScript, {{c1::const}} declares a block-scoped variable that cannot be {{c2::reassigned}}.

Вклад в проект

1. Сделайте форк репозитория

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

3. Запустите тесты: npm test

4. Отправьте запрос на слияние (pull request)

История звезд

Авторы

Иконка предоставлена macOS Icons

Лицензия

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