vionwinnie jap vocab anki mcp server

A Model Context Protocol server implementation for interacting with Anki decks programmatically. This server allows Language Models to interact with Anki through a standardized interface, with special support for Japanese language learning.

This is vibe-coded with Cursor with Claude 3.5 Sonnet.

• List available decks
• View cards in decks
• Add new cards
• Review cards with spaced repetition
• Import Japanese vocabulary with readings and meanings
• Add sample sentences to Japanese vocabulary cards
• Track review history and learning progress

Here's a complete workflow showing how to use Claude to enhance your Japanese vocabulary cards with sample sentences.

First, ask Claude to create practice exercises using the study_japanese_vocab_prompt:

Claude will look through your recently reviewed vocabulary and create contextual sentences with blanks to test your understanding.

Next, use the vocab_sentences_json_prompt to convert these sentences into a structured format:

Claude will transform the sentences into a JSON dictionary mapping each vocabulary word to its sample sentences.

Finally, use the update_notes_with_sentences tool to add these sentences to your Anki cards:

The sentences will be added to the reading field of each vocabulary card, providing more context for your studies.

After the update, your cards will include the new sample sentences:

This workflow helps you:

1. Practice vocabulary in context through fill-in-the-blank exercises
2. Add natural example sentences to your cards
3. Build a more comprehensive understanding of each word's usage

1. Clone this repository:

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

1. Make sure Anki is not running (to avoid database locks)

2. Set the path to your Anki collection (optional):

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

1. Run the server:

python -m anki_mcp.server

• anki://decks - List all available Anki decks
• anki://deck/{deck_name}/cards - List all cards in a specific deck
• anki://recent/reviewed - View cards reviewed in the last 24 hours
• anki://recent/learned - View cards learned (graduated from new) in the last 24 hours

• add_card(deck_name: str, front: str, back: str) - Add a new card to a deck
• review_card(card_id: int, ease: int) - Review a card with a specific ease (1-4)
• get_card_history(card_id: int) - Get detailed review history for a specific card

• import_japanese_vocab(csv_path: str, deck_name: str, tags: str = None) - Import Japanese vocabulary from CSV
• update_notes_with_sentences(vocab_sentences: Dict[str, List[str]], deck_name: str = "Try! N3 Vocab") - Add sample sentences to vocabulary notes

• get_deck_review_history(deck_name: str) - Get review history for all cards in a deck within the past 24 hours

• create_deck_prompt(deck_name: str) - Get help creating a new deck
• review_history_prompt() - Get help analyzing review history
• study_japanese_vocab_prompt() - Get help with Japanese vocabulary study
• vocab_sentences_json_prompt() - Generate JSON dictionary mapping vocab to sample sentences

The server expects a note type called "Japanese (recognition)" with the following fields:

1. Expression (Japanese word)
2. Meaning (English meaning)
3. Reading (with furigana and sample sentences)

MIT License