Japanese Vocab Anki MCP Server

Japanese Vocab Anki MCP Server

Anki デッキとプログラムからやり取りするための Model Context Protocol サーバー実装です。このサーバーを使うと、標準化されたインターフェースを通じて、言語モデルが Anki とやり取りできます。日本語学習を特にサポートしています。

これは Cursor と Claude 3.5 Sonnet を使ったバイブコーディングで作成されました。

機能

• 利用可能なデッキの一覧表示
• デッキ内のカードの表示
• 新しいカードの追加
• 間隔反復によるカードの復習
• 読みと意味を含む日本語の語彙のインポート
• 日本語の語彙カードへの例文の追加
• 復習履歴と学習の進捗の追跡

エンドツーエンドの例：Claude を使った日本語の語彙学習

Claude を使って日本語の語彙カードに例文を追加するワークフローを紹介します。

ステップ 1：空欄補充問題を生成する

まず、study_japanese_vocab_prompt を使って練習問題を作成するよう Claude に依頼します。

Claude は最近復習した語彙を確認し、理解度を試すための、空欄を含む文脈に沿った文章を作成します。

ステップ 2：例文に変換する

次に、vocab_sentences_json_prompt を使って、これらの文章を構造化された形式に変換します。

Claude は文章を、各語彙とその例文を対応付ける JSON 辞書に変換します。

ステップ 3：Anki カードを更新する

最後に、update_notes_with_sentences ツールを使って、これらの文章を Anki カードに追加します。

各語彙カードの「Reading」フィールドに文章が追加され、学習のための文脈が充実します。

Anki での結果

更新後、カードには新しい例文が追加されています。

このワークフローでは、次のことができます。

1. 空欄補充問題を通じて、文脈の中で語彙を練習する
2. 自然な例文をカードに追加する
3. 各単語の使い方をより包括的に理解する

インストール

1. このリポジトリをクローンします。

git clone https://github.com/vionwinnie/jap-vocab-anki-mcp-server.git
cd jap-vocab-anki-mcp-server

使い方

1. （データベースのロックを避けるため）Anki が起動していないことを確認します。

2. Anki コレクションへのパスを設定します（任意）。

export ANKI_COLLECTION_PATH="/path/to/your/collection.anki2"

3. サーバーを実行します。

python -m anki_mcp.server

利用可能なリソース

• anki://decks - 利用可能な Anki デッキをすべて一覧表示します
• anki://deck/{deck_name}/cards - 指定したデッキ内のカードをすべて一覧表示します
• anki://recent/reviewed - 過去 24 時間に復習したカードを表示します
• anki://recent/learned - 過去 24 時間に習得したカード（新規から卒業したカード）を表示します

利用可能なツール

基本的なカード管理

• add_card(deck_name: str, front: str, back: str) - デッキに新しいカードを追加します
• review_card(card_id: int, ease: int) - 指定した易しさ（1〜4）でカードを復習します
• get_card_history(card_id: int) - 指定したカードの詳細な復習履歴を取得します

日本語の語彙学習機能

• import_japanese_vocab(csv_path: str, deck_name: str, tags: str = None) - CSV から日本語の語彙をインポートします
• update_notes_with_sentences(vocab_sentences: Dict[str, List[str]], deck_name: str = "Try! N3 Vocab") - 語彙ノートに例文を追加します

復習履歴

• get_deck_review_history(deck_name: str) - 過去 24 時間における、デッキ内のすべてのカードの復習履歴を取得します

利用可能なプロンプト

• create_deck_prompt(deck_name: str) - 新しいデッキの作成をサポートします
• review_history_prompt() - 復習履歴の分析をサポートします
• study_japanese_vocab_prompt() - 日本語の語彙学習をサポートします
• vocab_sentences_json_prompt() - 語彙と例文を対応付ける JSON 辞書を生成します

日本語ノートタイプの要件

このサーバーは、次のフィールドを持つ「Japanese (recognition)」というノートタイプを想定しています。

1. Expression（日本語の単語）
2. Meaning（英語の意味）
3. Reading（ふりがなと例文を含む読み）

ライセンス

MIT License