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