MCP-AnkiConnect

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Connects to Anki via AnkiConnect to enable flashcard management, including retrieving due cards, submitting reviews, adding new cards, and accessing deck information for spaced repetition learning.

mcp-ankiconnect MCP 服务器

通过 MCP 将 Claude 对话与 AnkiConnect 连接起来,使间隔重复变得像“让我们浏览今天的抽认卡”或“为此制作抽认卡”一样简单

成分

工具

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

  • num_cards_due_today :获取今天到期的卡片数量
    • 可选的deck参数用于按特定 deck 进行过滤
    • 返回所有牌组或指定牌组的到期牌数
  • get_due_cards :获取需要审核的卡片
    • 可选的limit参数(默认值:5)用于控制卡片数量
    • 可选的deck参数用于按特定 deck 进行过滤
    • 可选的today_only参数(默认值:true)仅显示今天的卡片
    • 以 XML 格式返回包含问题和答案的卡片
  • submit_reviews :提交已审核卡片的答案
    • 获取带有card_idratingreviews列表
    • 评分:“错误”、“困难”、“好”、“简单”
    • 返回已提交评论的确认

配置

先决条件

  • Anki 运行时必须安装AnkiConnect 插件(插件 ID 2055492159)。由于 AppSleep 功能,AnkiConnect 在 Mac 上运行速度可能会比较慢,因此请为 Anki 禁用该功能。为此,请在终端中运行以下命令。
    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\ 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 桌面

调试

由于 MCP 服务器通过 stdio 运行,调试起来可能比较困难。为了获得最佳调试体验,我们强烈建议使用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

启动后,检查器将显示一个 URL,您可以在浏览器中访问该 URL 以开始调试。

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

将 Claude 与 Anki 抽认卡集成的 MCP 服务器,允许用户通过对话直接查看到期卡片并创建新的抽认卡。

  1. Components
    1. Tools
  2. Configuration
    1. Prerequisites
    2. Installation
  3. Quickstart
    1. Debugging
ID: nicr30wt6y