Scorzeth Anki MCP Server

🚀 Anki MCP 服务器

Anki MCP 服务器是一个实现的 MCP 服务器，它可与本地运行的 Anki 进行连接，为用户提供卡片复习和创建的功能。此服务器专门为 Anki 桌面应用程序 和 Anki-Connect 插件而设计。

🚀 快速开始

开发步骤

1. 安装依赖

   npm install
   

2. 构建服务器

   npm run build
   

3. 使用自动重建进行开发

   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 的 如何编写良好的提示。