Anki MCP Server

Anki MCP Server

人気の間隔反復式フラッシュカードソフトウェアである Anki と AI アシスタントを連携するための、Model Context Protocol（MCP）サーバーです。

機能

この MCP サーバーを使うと、AI アシスタントは以下のツールを通じて Anki とやり取りできます。

ツール

• get-collection-overview：利用可能なデッキ、モデル、および各モデルのフィールドなど、Anki コレクションの概要を返します。

• add-or-update-notes：新しいノートを追加するか、既存のノートを更新します。複数のノートを一度にまとめて追加・更新できます。

• get-cards-reviewed：日ごとの復習済みカード数を取得します。

• find-notes：Anki の検索構文を使ってノートを検索できます。

• find-cards：Anki でクエリに一致するカード ID を検索します。

• suspend-cards：カード ID を指定してカードを一時停止します。

• unsuspend-cards：カード ID を指定してカードの一時停止を解除します。

リソース

• anki://docs/search-syntax：Anki の検索クエリ構文を網羅したリファレンスガイドです。基本演算子、フィールド検索、タグ、デッキ、カードの状態、プロパティ、タイミング、ID、カスタムデータ、高度なクエリの例が含まれています。このリソースには、find-notes ツールや find-cards ツールで検索クエリを作成する際に役立つ、言語に依存しないドキュメントが用意されています。

必要条件

• Anki がインストールされ、実行中であること
• AnkiConnect アドオンが Anki にインストールされ、実行中であること
• この MCP サーバーでは uv を使用します。uv のインストール方法については、公式手順を参照してください。

インストール

Claude Code プラグインとして（推奨）

プラグインとしてインストールすると、MCP サーバーと言語学習スキルの両方を一度に利用できます。

/plugin install anki-mcp

Claude Code への手動セットアップ

1. MCP サーバーを追加します。

   claude mcp add anki -- uvx anki-mcp
   

2. 必要に応じて、言語学習のガイダンスを利用するために、skills/ 内のスキルファイルをプロジェクトの .claude/skills/ ディレクトリにコピーします。

Claude Desktop

1. Claude Desktop の設定ファイルを開きます。

   • macOS：~/Library/Application\ Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%/Claude/claude_desktop_config.json

2. mcpServers セクションに anki-mcp を追加します。

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

3. Claude Desktop を再起動します。

MCP サーバーのみ

その他の MCP 対応クライアントでは、サーバーを直接実行します。

uvx anki-mcp

言語学習スキル

このプラグインには、効果的な言語学習用フラッシュカードを作成するためのベストプラクティスを紹介する、補完的なスキルが含まれています。プラグインとしてインストールすると、このスキルを自動的に利用できます。スキルの内容は次のとおりです。

• カード作成におすすめのワークフロー
• カードの品質に関するガイドライン（長さ、内容、穴埋め問題の使い方）
• ノートタイプの種類に関する推奨事項
• 良いカードと悪いカードの例
• 習熟度レベルに関するガイドライン（CEFR A1-C2）

MCP サーバーはスキルとは独立して動作するため、言語学習に限らず、あらゆる Anki ワークフローで使用できます。