Ankiconnect

🚀 使用 MCP-ankiconnect MCP 服務器將 Claude 對話與 AnkiConnect 連接起來

通過 MCP 將 Claude 的對話與 AnkiConnect 連接起來，讓間隔重複學習變得異常輕鬆，只需簡單說一句“讓我們回顧今天的閃卡”或“為這個內容創建閃卡”即可。

✨ 主要特性

該服務器實現了三個實用工具，能助力你更高效地使用 Anki 進行學習：

• num_cards_due_today：獲取今天到期的卡片數量。
  • 支持可選的 deck 參數，可按特定牌組進行過濾。
  • 最終返回所有牌組或指定牌組中到期卡片的數量。
• get_due_cards：獲取需要複習的卡片。
  • 可選的 limit 參數（默認值為 5），可控制返回的卡片數量。
  • 可選的 deck 參數，用於按特定牌組過濾。
  • 可選的 today_only 參數（默認值為 true），用於僅顯示今天到期的卡片。
  • 返回包含問題和答案的 XML 格式卡片。
• submit_reviews：提交已審核卡片的答案。
  • 接收包含 card_id 和 rating 的 reviews 列表。
  • 評分選項包括：wrong、hard、good、easy。
  • 返回確認已提交的反饋信息。

📦 安裝指南

先決條件

• 必須安裝 Anki 並且運行帶有 AnkiConnect 插件（插件 ID 2055492159）。

  ⚠️ 重要提示

  如果你在 Mac 上使用，由於 AppSleep 特性可能導致 AnkiConnect 變慢，建議禁用它。可以通過運行以下命令實現：

  defaults write net.ankiweb.dtop NSAppSleepDisabled -bool true
  defaults write net.ichi2.anki NSAppSleepDisabled -bool true
  defaults write org.qt-project.Qt.QtWebEngineCore NSAppSleepDisabled -bool true
  

安裝步驟

1. 在 Anki 中安裝 AnkiConnect 插件：
   • 依次點擊：工具 > 插件管理器 > 獲取插件...
   • 輸入代碼：2055492159
   • 重啟 Anki
2. 配置 Claude 桌面：
   • 對於 MacOS，編輯路徑為 ~/Library/Application\ 支持/Claude/claude_desktop_config.json。
   • 對於 Windows，則是 %APPDATA%/Claude/claude_desktop_config.json。 添加以下配置：

   {
     "mcpServers": {
       "mcp-ankiconnect": {
         "command": "uv",
         "args": ["運行", "--with", "mcp-ankiconnect", "mcp-ankiconnect"]
       }
     }
   }
   

3. 重啟 Anki 和 Claude 桌面

🚀 快速開始

按照上述安裝指南完成安裝和配置後，你就可以使用 MCP-ankiconnect MCP 服務器將 Claude 對話與 AnkiConnect 連接起來，開啟高效的間隔重複學習之旅啦。

🔧 技術細節

調試說明

由於 MCP 服務器通過標準輸入輸出運行，調試可能會比較困難。為了獲得最佳的調試體驗，我們強烈推薦使用 MCP 調試工具。 具體操作如下：

1. 克隆倉庫並安裝依賴項：

git clone https://github.com/samefarrar/mcp-ankiconnect.git
cd mcp-ankiconnect
uv sync

2. 通過 mcp CLI 啟動 MCP 調試工具：

uv 運行 mcp dev mcp_ankiconnect/server.py

啟動後，調試工具會在瀏覽器中顯示一個 URL，你可以在其中開始調試。