Anki MCP 服务器

这是一个连接到本地运行的Anki的MCP服务器实现，提供卡片复习和创建功能。

此服务器旨在与Anki桌面应用和Anki-Connect插件一起使用。

在使用前，请确保已安装该插件。

资源

• anki://search/deckcurrent
  • 返回当前牌组中的所有卡片
  • 等同于Anki中的deck:current
• anki://search/isdue
  • 返回等待复习的学习卡片
  • 等同于Anki中的is:due
• anki://search/isnew
  • 返回所有未见卡片
  • 等同于Anki中的is:new

工具

• update_cards

  • 将给定卡片ID的卡片标记为已回答，并给予它们一个介于1（再次）和4（容易）之间的易度评分
  • 输入：
    • answers (数组)：包含cardId (数字) 和 ease (数字) 字段的对象数组

• add_card

  • 在默认的Anki牌组中创建一张新卡片
  • 输入：
    • front (字符串)：卡片正面
    • back (字符串)：卡片背面

• get_due_cards

  • 返回当前需要复习的n张卡片
  • 输入：
    • num (数字)：卡片数量

• get_new_cards

  • 返回n张新卡片
  • 输入：
    • num (数字)：卡片数量

开发

安装依赖项：

npm install

构建服务器：

npm run build

开发时自动重建：

npm run watch

配置

要与Claude Desktop一起使用，请添加服务器配置：

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

{
  "mcpServers": {
    "anki-mcp-server": {
      "command": "/path/to/anki-mcp-server/build/index.js"
    }
  }
}

调试

由于MCP服务器通过标准I/O进行通信，调试可能会比较困难。我们推荐使用MCP Inspector，它作为一个包脚本可用：

npm run inspector

Inspector将提供一个URL，以便您可以在浏览器中访问调试工具。