AnkiConnect

🚀 使用 MCP-ankiconnect MCP 服务器将 Claude 对话与 AnkiConnect 连接起来

通过 MCP 将 Claude 的对话与 AnkiConnect 连接起来，让间隔重复学习变得轻而易举，只需简单说一句“让我们回顾今天的闪卡”或“为这个内容创建闪卡”即可。

🚀 快速开始

配置先决条件

• 必须安装 Anki 并且运行带有 AnkiConnect 插件（插件 ID 2055492159）。

  ⚠️ 重要提示

  如果你在 Mac 上使用，由于 AppSleep 特性可能导致 AnkiConnect 变慢，建议禁用它。可以通过运行以下命令实现：

  defaults write net.ankiweb.dtop NSAppSleepDisabled -bool true
  defaults write net.ichi2.anki NSAppSleepDisabled -bool true
  defaults write org.qt-project.Qt.QtWebEngineCore NSAppSleepDisabled -bool true
  

安装步骤

1. 在 Anki 中安装 AnkiConnect 插件：

   • 依次点击：工具 > 插件管理器 > 获取插件...
   • 输入代码：2055492159
   • 重启 Anki

2. 配置 Claude 桌面：

   • 对于 MacOS，编辑路径为 ~/Library/Application\ 支持/Claude/claude_desktop_config.json
   • 对于 Windows，则是 %APPDATA%/Claude/claude_desktop_config.json

   添加以下配置：

   {
     "mcpServers": {
       "mcp-ankiconnect": {
         "command": "uv",
         "args": ["运行", "--with", "mcp-ankiconnect", "mcp-ankiconnect"]
       }
     }
   }
   

3. 重启 Anki 和 Claude 桌面

✨ 主要特性

工具

该服务器实现了三个实用工具：

• num_cards_due_today：获取今天到期的卡片数量

  • 可选 deck 参数，用于按特定牌组过滤。
  • 会返回所有牌组或指定牌组中到期卡片的数量。

• get_due_cards：获取需要复习的卡片

  • 可选 limit 参数（默认值为 5），用于控制卡片数量。
  • 可选 deck 参数，用于按特定牌组过滤。
  • 可选 today_only 参数（默认值为 true），用于仅显示今天到期的卡片。
  • 返回包含问题和答案的 XML 格式卡片。

• submit_reviews：提交已审核卡片的答案

  • 接收包含 card_id 和 rating 的 reviews 列表。
  • 评分选项：wrong、hard、good、easy。
  • 返回确认已提交的反馈信息。

🔧 技术细节

调试说明

由于 MCP 服务器通过标准输入输出运行，调试可能会比较困难。为了获得最佳的调试体验，我们强烈推荐使用 MCP 调试工具。

调试步骤

1. 首先克隆仓库并安装依赖项：

git clone https://github.com/samefarrar/mcp-ankiconnect.git
cd mcp-ankiconnect
uv sync

2. 你可以通过 mcp CLI 启动 MCP 调试工具：

uv 运行 mcp dev mcp_ankiconnect/server.py

启动后，调试工具会在浏览器中显示一个 URL，你可以在其中开始调试。