项目简介

Anki 课程辅导 MCP 服务器是一个 AI 驱动的学习系统后端，它将 Anki 的间隔重复学习方法与人工智能辅导功能相结合。通过一个聊天界面，用户可以与 AI 进行自然对话，获取解释、回顾知识点，并直接同步学习进度到 Anki。

主要功能点

聊天式学习: 通过 MCP 协议提供自然语言对话的学习界面。
AI 智能解释: 对错误答案提供上下文相关的 AI 解释。
用户复核系统: 允许用户确认或覆盖系统对答案的自动评估。
学习进度追踪: 记录详细的学习统计数据和分析。
Anki 调度器集成: 直接将学习结果提交至 Anki 的间隔重复调度系统。
多种学习模式: 支持“解释模式”（提供 AI 解释）和“测试模式”（仅评估）。
多种卡片类型: 支持基本卡片、挖空、多选、单选和 KPRIM 卡片。
灵活的答案格式: 针对 KPRIM 问题，支持 R/F、T/F、Y/N 或 1/0 等多种输入格式。

安装步骤

克隆仓库:

git clone https://github.com/mkrech/anki-course-tutor-mcp-server
cd anki-course-tutor-mcp-server

安装依赖 (推荐使用 uv):

uv sync

或者使用 pip:

pip install -e ".[dev]"

Anki 设置:
- 确保已安装 Anki 桌面版。
- 在 Anki 中安装 AnkiConnect 插件 (代码: '2055492159')。
- 使用辅导系统时，Anki 必须在后台运行。
配置: 编辑项目根目录下的 'config.yaml' 文件以自定义 Anki 连接、学习模式、评估行为和存储路径等设置。

服务器配置 (供 MCP 客户端连接)

MCP 客户端需要配置服务器的启动命令。以下是 'claude_desktop_config.json' 的示例配置，用于将 Anki 课程辅导 MCP 服务器添加到 Claude Desktop 等客户端：

{
  "mcpServers": {
    "anki-course-tutor": {
      "command": "uv",
      "args": [
        "--directory",
        "/full/path/to/anki-course-tutor-mcp-server",
        "run",
        "anki-course-tutor"
      ]
    }
  }
}

'"anki-course-tutor"': MCP 服务器在客户端中的名称，您可以自定义。
'"command"': 启动服务器的命令，这里使用 'uv' (如果未安装 'uv'，您可能需要使用 'python' 或其他启动器)。
'"args"': 传递给命令的参数列表。
- '"--directory", "/full/path/to/anki-course-tutor-mcp-server"': 指定服务器代码的完整路径。请务必将 '"/full/path/to/anki-course-tutor-mcp-server"' 替换为您的实际仓库路径。
- '"run", "anki-course-tutor"': 运行 'anki-course-tutor' 模块作为服务器。

配置完成后，重启您的 MCP 客户端即可连接到 Anki 课程辅导 MCP 服务器。

基本使用方法

在连接到 MCP 客户端后，您可以通过聊天界面与服务器交互：

列出 Anki 牌组: 'List my Anki decks'
开始学习会话: 'Start a learning session with Spanish Vocabulary in EXPLAIN mode'
获取下一张卡片: 'Next card'
提交答案: 'How are you?'
确认评估: 'yes' (如果您认为答案正确) 或 'no' (如果您认为答案错误)
获取解释 (仅解释模式): 'get_explanation'
结束会话: 'end_session'

关键词

项目简介

主要功能点

安装步骤

服务器配置 (供 MCP 客户端连接)

基本使用方法

信息