Vionwinnie Jap Vocab Anki MCP Server

🚀 日本語 Anki MCP 服務器

這是一個基於 Model Context Protocol 的服務器實現，藉助標準接口可程序化地與 Anki 卡組交互。該服務器專為日語學習打造，支持語言模型通過統一接口與 Anki 進行交互，為日語學習提供便利。

✨ 主要特性

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

🚀 快速開始

端到端示例：使用 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(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_review_history() - 獲取所有用戶的複習歷史記錄
• get_deck_stats(deck_name: str) - 獲取特定卡組的統計數據
• export_cards(deck_name: str, filename: str) - 導出卡組為 CSV 文件

預設提示

生成填空練習

# 填空練習提示
response = client.chat.completions.create(
    model=" Claude-2",
    messages=[
        {
            "role": "system",
            "content": """作為日語老師，為學生創建填空練習。根據提供的詞彙，生成合適的句子，並用空白 _ _ _ 填充目標詞彙。保持句子簡潔明瞭，適合初級學習者。輸出格式：每個句子換行，以 JSON 格式返回."""
        },
        {
            "role": "user",
            "content": "日語詞彙：忍者、學校、公園"
        }
    ],
    temperature=0.7,
)

轉換為結構化數據

# 結構化轉換提示
response = client.chat.completions.create(
    model=" Claude-2",
    messages=[
        {
            "role": "system",
            "content": """將不完整的句子 JSON 轉換為結構化的日語例句。輸出格式：每個句子應包括原句、空白形式和正確填空."""
        },
        {
            "role": "user",
            "content": "[[\"原句\",\"_ _ _, あなたはプログラマーです。\"],[\"空白形式\",\"_ _ _ , あなたはプログラマーです。\"]]"
        }
    ],
    temperature=0.7,
)

📚 詳細文檔

日語筆記類型要求

• 表達：日語詞彙或短語
• 含義：對應的英文翻譯和發音（如："ninja" /ˈninjə/)
• 發音：假名，包括例句和空白形式

示例：

{
  "expression": "忍者",
  "reading": "にんじゃ",
  "meaning": "ninja",
  "sentences": [
    {
      "original": "忍者は公園で稽古をしていた。",
      "blank": "_ _ _ は公園でけいじゅうをしていた。",
      "correct": "忍者"
    }
  ]
}

此項目為日語學習者提供了一個強大的工具，通過與 Anki 的集成，顯著提升詞彙學習的效果。