Japanese Vocab Anki MCP Server

日语词汇 Anki MCP 服务

这是一个用于通过程序与 Anki 牌组交互的 Model Context Protocol 服务实现。此服务允许大模型通过标准化接口与 Anki 交互，并特别支持日语学习。

这是使用 Cursor 和 Claude 3.5 Sonnet 通过 vibe coding 编写的。

功能

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

端到端示例：使用 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"

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_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. Expression（日语词语）
2. Meaning（英文释义）
3. Reading（含振假名和例句）

许可证

MIT 许可证