Japanese Vocab Anki MCP Server

基本能力

产品定位

Japanese Vocab Anki MCP Server 是一个专门为日语学习者设计的 Anki 交互服务，通过标准化接口实现与 Anki 卡片的程序化交互，特别支持日语词汇学习。

核心功能

• 列出可用的 Anki 卡片组
• 查看卡片组中的卡片
• 添加新卡片
• 通过间隔重复复习卡片
• 导入日语词汇（包括读音和含义）
• 为日语词汇卡片添加例句
• 跟踪复习历史和学习进度

适用场景

• 日语学习者通过程序化方式管理 Anki 卡片
• 语言模型与 Anki 交互，增强学习体验
• 自动化添加日语词汇和例句到 Anki 卡片

工具列表

基本卡片管理

• add_card(deck_name: str, front: str, back: str) - 向卡片组添加新卡片
• review_card(card_id: int, ease: int) - 以特定 ease 值（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 小时的复习历史

常见问题解答

• 需要特定的 Anki 笔记类型 "Japanese (recognition)"，包含 Expression、Meaning 和 Reading 字段
• 运行服务前需确保 Anki 未运行以避免数据库锁定

使用教程

使用依赖

• 需要安装 Python
• 需要安装 Anki

安装教程

1. 克隆仓库：

git clone https://github.com/vionwinnie/jap-vocab-anki-mcp-server.git
cd jap-vocab-anki-mcp-server

1. 设置 Anki 集合路径（可选）：

export ANKI_COLLECTION_PATH="/path/to/your/collection.anki2"

1. 运行服务：

python -m anki_mcp.server

调试方式

• 确保 Anki 未运行
• 检查 ANKI_COLLECTION_PATH 是否正确设置
• 运行服务后，可以通过提供的 API 端点进行测试，如 anki://decks 列出所有可用卡片组

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。