🚀 日语词汇 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中的结果
更新后，你的卡片将包含新的例句：
这个流程帮助你：
- 通过填空练习在上下文中实践日语词汇
- 将自然的例句添加到卡片中
- 建立对每个单词用法更全面的理解
📦 安装指南
- 克隆此仓库：
git clone https://github.com/vionwinnie/jap-vocab-anki-mcp-server.git
cd jap-vocab-anki-mcp-server
💻 使用示例
基本的使用步骤
- 确保Anki没有运行（避免数据库锁定）。
- 设置Anki收藏夹路径（可选）：
export ANKI_COLLECTION_PATH="/path/to/your/collection.anki2"
- 启动服务器：
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获取详细信息。