日语词汇 Anki MCP 服务器

这是一个用于以编程方式与 Anki 卡组交互的 Model Context Protocol 服务器实现。此服务器允许语言模型通过标准化接口与 Anki 交互，特别支持日语学习。

这是使用 Cursor 和 Claude 3.5 Sonnet 编写的 vibe 代码。

特性

• 列出可用卡组
• 查看卡组中的卡片
• 添加新卡片
• 使用间隔重复法复习卡片
• 导入带有读音和含义的日语词汇
• 向日语词汇卡片添加例句
• 跟踪复习历史和学习进度

端到端示例：使用 Claude 学习日语词汇

这里是一个完整的工作流程，展示如何使用 Claude 来增强你的日语词汇卡片，为其添加例句。

步骤 1：生成填空练习

首先，让 Claude 使用 study_japanese_vocab_prompt 创建练习题：

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"

1. 运行服务器：

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_deck_review_history(deck_name: str) - 获取过去24小时内某个牌组中所有卡片的复习历史

可用提示

• create_deck_prompt(deck_name: str) - 获取创建新牌组的帮助
• review_history_prompt() - 获取分析复习历史的帮助
• study_japanese_vocab_prompt() - 获取日语词汇学习的帮助
• vocab_sentences_json_prompt() - 生成将词汇映射到例句的 JSON 字典

日语笔记类型要求

服务器期望有一种名为“Japanese (recognition)”的笔记类型，包含以下字段：

1. 表达（日语单词）
2. 意义（英文意思）
3. 读音（带假名和例句）

许可证

MIT 许可证