Japanese Vocab Anki MCP Server

日语词汇 Anki MCP 服务器

一个模型上下文协议 (MCP) 服务器实现，用于以编程方式与 Anki 卡片组交互。该服务器允许语言模型通过标准化接口与 Anki 交互，并特别支持日语学习。

这是用 Claude 3.5 Sonnet 和 Cursor 进行氛围编码的。

特征

• 列出可用的卡组
• 查看牌组中的卡牌
• 添加新卡
• 间隔重复复习卡片
• 导入日语词汇及其读音和含义
• 将例句添加到日语词汇卡中
• 追踪复习历史和学习进度

端到端示例：与 Claude 一起学习日语词汇

这里有一个完整的工作流程，展示如何使用 Claude 通过例句来增强您的日语词汇卡。

步骤 1：生成填空练习

首先，要求 Claude 使用study_japanese_vocab_prompt创建练习：

克劳德将查看您最近复习的词汇并创建带有空格的上下文句子来测试您的理解。

第 2 步：转换为例句

接下来，使用vocab_sentences_json_prompt将这些句子转换为结构化格式：

Claude 会将句子转换成 JSON 字典，将每个词汇映射到其示例句子。

步骤3：更新Anki卡片

最后，使用update_notes_with_sentences工具将这些句子添加到你的 Anki 卡片中：

句子将被添加到每个词汇卡的阅读栏中，为您的学习提供更多背景。

Anki 中的结果

更新后，您的卡片将包含新的例句：

此工作流程可帮助您：

1. 通过填空练习在上下文中练习词汇
2. 在卡片中添加自然例句
3. 更全面地了解每个单词的用法

安装

1. 克隆此存储库：

用法

1. 确保 Anki 没有运行（以避免数据库锁定）
2. 设置你的 Anki 集合的路径（可选）：

3. 运行服务器：

可用资源

• 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 字典

日本纸币类型要求

服务器期望一种名为“日语（识别）”的笔记类型，其中包含以下字段：

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

执照

MIT 许可证