Jap Vocab Anki MCP Server

🚀 日语词汇 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中的结果

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

这个流程帮助你：

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(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获取详细信息。