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"
  • 返回提交复习的确认信息

配置

前提条件

• 必须安装并运行 AnkiConnect 插件（插件 ID 2055492159） 由于 AppSleep 功能，AnkiConnect 在 Mac 上可能会很慢，因此需要为 Anki 禁用它。在终端中运行以下命令： bash 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

   添加以下配置： json { "mcpServers": { "mcp-ankiconnect": { "command": "uv", "args": ["run", "--with", "mcp-ankiconnect", "mcp-ankiconnect"] } } }

3. 重启 Anki 和 Claude 桌面应用

调试

由于 MCP 服务器通过标准输入输出运行，调试可能会比较困难。为了获得最佳调试体验，我们强烈建议使用 MCP Inspector。 首先，克隆仓库并安装依赖项：

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

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

bash uv run mcp dev mcp_ankiconnect/server.py

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