Jap Vocab Anki MCP Server

🚀 日語詞彙 Anki MCP 服務器

本項目是一個實現與 Anki 卡組程序化交互的 Model Context Protocol (MCP) 服務器。該服務器專為日語學習場景打造，支持語言模型通過標準化接口與 Anki 進行互動，為日語學習提供了便利和高效的解決方案。

本項目採用 Cursor（Claude 3.5 Sonnet） vibe 編碼。

✨ 主要特性

• 列出可用牌組
• 查看牌組中的卡片
• 添加新卡片
• 使用間隔重複複習卡片
• 導入日語詞彙及其發音和含義
• 為日語詞彙卡片添加例句
• 跟蹤複查歷史和學習進度

🚀 快速開始

端到端示例：使用Claude增強日語詞彙學習

以下是一個完整的流程示例，展示如何利用Claude來提升你的日語詞彙學習體驗。

第一步：生成填空練習題

首先，請求Claude創建基於上下文的練習題，使用study_japanese_vocab_prompt：

Claude會從你最近複習的詞彙中生成包含空白的句子，以測試你的理解能力。

第二步：轉換為例句

接下來，利用vocab_sentences_json_prompt將這些句子轉換為結構化的格式：

Claude將這些句子轉化為JSON字典，每個日語詞彙映射到其對應的例句列表。

第三步：更新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獲取詳細信息。