vionwinnie_jap-vocab-anki-mcp-server

The Japanese Vocab Anki MCP Server is designed to facilitate interaction with Anki decks through a standardized interface, particularly for Japanese language learners. It allows Language Models to manage Anki decks, view and add cards, and track learning progress. The server supports importing Japanese vocabulary with readings and meanings, adding sample sentences, and reviewing cards using spaced repetition. This implementation is vibe-coded with Cursor and Claude 3.5 Sonnet, providing a comprehensive tool for enhancing language learning through Anki.

Features

• List available decks
• View cards in decks
• Add new cards
• Review cards with spaced repetition
• Import Japanese vocabulary with readings and meanings

MCP Tools

• add_card: Add a new card to a deck
• review_card: Review a card with a specific ease (1-4)
• get_card_history: Get detailed review history for a specific card
• import_japanese_vocab: Import Japanese vocabulary from CSV
• update_notes_with_sentences: Add sample sentences to vocabulary notes

MCP Resources

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

Usage with Different Platforms

installation

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

usage

bash
# Make sure Anki is not running (to avoid database locks)

# Set the path to your Anki collection (optional):
export ANKI_COLLECTION_PATH="/path/to/your/collection.anki2"

# Run the server:
python -m anki_mcp.server