Japanese Vocab Anki MCP Server

Japanese Vocab Anki MCP Server

site icon
2025.04.20 0
PythonAnki 交互日语学习卡片管理内容生成
Japanese Vocab Anki MCP Server 是一个基于 Model Context Protocol 的服务实现,用于通过编程方式与 Anki 卡片进行交互。该服务特别支持日语学习,允许语言模型通过标准化接口与 Anki 互动。
View on GitHub

Overview

基本能力

产品定位

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

核心功能

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

适用场景

  • 日语学习者通过程序化方式管理 Anki 卡片
  • 语言模型与 Anki 卡片交互
  • 自动化日语词汇学习流程
  • 为现有卡片添加例句和上下文

工具列表

  1. 基本卡片管理
  2. add_card: 向卡片组添加新卡片
  3. review_card: 使用特定 ease 值复习卡片
  4. get_card_history: 获取特定卡片的详细复习历史

  5. 日语词汇特性

  6. import_japanese_vocab: 从 CSV 导入日语词汇
  7. update_notes_with_sentences: 为词汇笔记添加例句

  8. 复习历史

  9. get_deck_review_history: 获取卡片组过去24小时的复习历史

常见问题解答

  • 使用前需确保 Anki 未运行(避免数据库锁定)
  • 需要特定格式的日语笔记类型("Japanese (recognition)")

使用教程

使用依赖

  • 需要安装 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 集合路径是否正确
  • 确保使用正确的笔记类型和字段格式

许可证

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