Jap Vocab Anki MCP Server

🚀 日本語語彙 Anki MCP サーバー

このサーバーは、Anki カードセットとのプログラムによる対話を実現する Model Context Protocol (MCP) サーバーです。特に日本語学習をサポートしており、言語モデルが標準化されたインターフェースを通じて Anki とやり取りできるようになっています。

このプロジェクトは Cursor（Claude 3.5 Sonnet） vibe でコーディングされています。

✨ 主な機能

• 利用可能なカードセットをリスト表示
• カードセット内のカードを確認
• 新しいカードを追加
• 間隔繰り返しを使用してカードを復習
• 日本語語彙とその発音、意味をインポート
• 日本語語彙カードに例文を追加
• 復習履歴と学習進捗を追跡

📚 ドキュメント

エンドツーエンドの例：Claude を使用した日本語語彙学習の強化

以下は、Claude を利用して日本語語彙の学習体験を向上させる完全な流れの例です。

ステップ 1：穴埋め問題の生成

まず、study_japanese_vocab_prompt を使用して、Claude に文脈に基づく問題を作成するよう依頼します。

Claude は、最近復習した語彙から空白を含む文を生成し、あなたの理解度をテストします。

ステップ 2：例文への変換

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

Claude はこれらの文を JSON 辞書に変換し、各日本語語彙が対応する例文のリストにマッピングされます。

ステップ 3：Anki カードの更新

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

例文は語彙カードの「発音」フィールドに追加され、学習により多くの文脈情報を提供します。

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(deck_name: str, vocab_list: List[str]) -> bool - 指定されたカードセットに日本語語彙とその発音、意味をインポートしてカードを作成
• add_example_sentence(card_id: int, sentence: str) -> bool - 指定された日本語語彙カードに例文を追加

ヒント

• generate_learning_plan(days: int) -> List[Dict[str, Any]] - 学習計画を作成し、復習タスクを日単位で分配し、毎日の学習タスクを含むリストを返す
• track_progress() -> Dict[str, Any] - 学習進捗を追跡し、習得済みと未習得のカードの数を含む辞書を返す

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細については、LICENSE を参照してください。