Anki MCP Server

🚀 Anki MCP 服務器

Anki MCP 服務器可連接到本地運行的 Anki 實例，藉助 MCP（模型上下文協議）提供卡片複習和創建功能。該服務器專為 Anki 桌面應用程序 和 Anki-Connect 插件設計，使用前請確保已安裝此插件。

🚀 快速開始

使用本服務器前，請確保已安裝 Anki 桌面應用程序 和 Anki-Connect 插件。

📦 安裝指南

安裝依賴項

npm install

構建服務器

npm run build

帶自動重建開發

npm run watch

📚 詳細文檔

資源

• 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 (數字)：卡片數量。

🔧 技術細節

配置

要與 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 服務器通過 stdio 通信，調試可能具有挑戰性。我們建議使用 MCP Inspector，它作為包腳本可用：

npm run inspector

Inspector 將提供一個可在瀏覽器中訪問的調試工具 URL。