mcp-ankiconnect MCP 服务器

通过 MCP 将 Claude 对话与 AnkiConnect 连接起来，使间隔重复学习像“让我们浏览今天的闪卡”或“为这个内容制作闪卡”一样简单。

组件

工具

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

• 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"（容易）
  • 返回已提交审阅的确认信息

配置

前提条件

• Anki 必须安装并运行 AnkiConnect 插件（插件 ID 22055492159） 在 Mac 上，由于 AppSleep 功能，AnkiConnect 可能会变慢，因此需要禁用 Anki 的 AppSleep 功能。在终端中运行以下命令来实现这一点。

  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 Desktop：

   在 MacOS 上：~/Library/Application\ Support/Claude/claude_desktop_config.json 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

   添加以下配置：

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

3. 重启 Anki 和 Claude Desktop

调试

由于 MCP 服务器通过标准 I/O 运行，调试可能会很具有挑战性。为了获得最佳的调试体验，我们强烈建议使用 MCP Inspector。首先，克隆仓库并安装依赖项：

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

你可以通过 mcp CLI 启动 MCP Inspector：

uv run mcp dev mcp_ankiconnect/server.py

启动后，Inspector 将显示一个可以在浏览器中访问的 URL 开始调试。