Scorzeth Anki MCP Server

🚀 Anki MCP 服务器

Anki MCP 服务器实现了 MCP 协议，可与本地运行的 Anki 建立连接，为用户提供卡片复习和创建的功能。该服务器专为 Anki 桌面应用程序 和 Anki-Connect 插件量身设计。

🚀 快速开始

安装依赖

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-server": {
      "command": "/path/to/anki-server/build/index.js"
    }
  }
}

调试

由于 MCP 服务器通过 stdio 通信，调试可能存在一定挑战。我们推荐使用 MCP Inspector，它可作为包脚本使用：

npm run inspector

Inspector 会提供一个 URL，用于在浏览器中访问调试工具。

✨ 主要特性

资源

• 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 (字符串)：卡片背面内容。

提示

• high_quality_cards_prompt
  • 包含创建高质量卡片的指南的提示，该提示基于 Andy Matuschak 的 如何编写良好的提示。