Anki Leech Cards

🚀 Anki MCP 服務器

Anki MCP 服務器是專門為 Claude Desktop 設計的，它遵循模型上下文協議（MCP），藉助 AnkiConnect 與 Anki 建立連接，能夠檢索帶有“leech”標籤的卡片，為卡片管理和分析提供便利。

🚀 快速開始

Anki MCP 服務器是一個為 Claude Desktop 設計的工具，它能通過 AnkiConnect 連接 Anki，檢索特定卡片。在使用前，請確保滿足先決條件，並按照安裝步驟進行操作。

✨ 主要特性

• Anki 連接：藉助 AnkiConnect API 與 Anki 建立穩定連接。
• 卡片檢索：精準檢索帶有“leech”標籤的卡片。
• 審查標籤添加：為卡片添加帶有日期戳記的審查標籤。
• 數據提供：提供全面的卡片數據，便於 Claude 進行深入分析。
• 兼容性：可與 Claude Desktop 完美配合使用。

📦 安裝指南

先決條件

• 已安裝並運行 Anki，可從 這裡 獲取。
• Anki 中已安裝 AnkiConnect 插件，插件信息。
• 安裝 Node.js 和 npm。

安裝步驟

1. 克隆代碼倉庫：

   git clone <repository-url>
   

2. 安裝依賴項：

   npm install
   

3. 構建項目：

   npm run build
   

📚 詳細文檔

配置說明

通過環境變量配置參數：

如何找到本地 IP 地址

1. 打開 Anki，進入“工具”菜單。
2. 選擇“設置”。
3. 在“網絡”選項卡下查看“AnkiConnect 監聽地址”。

測試模式

為了在不修改實際 Anki 數據的情況下進行測試，請執行以下操作：

1. 設置 ANKI_MOCK_MODE=true 或使用 .env.test 文件。
2. 運行服務器：

   npm run start:test
   

工具使用說明

獲取 Leeched 卡片

通過指定查詢參數獲取卡片列表。

標記已審查卡片

格式為 見直し::YYYYMMDD（可自定義前綴）。 示例：

我已審閱這些卡片，請標記它們：[1234567890, 1234567891]

故障排除

• “無法連接到 Anki” - 確保 Anki 正在運行且 AnkiConnect 已正確安裝。
• “未找到任何 Leeched 卡片” - 您的 Anki 中沒有標記為“leech”的卡片。
• localhost 連接問題：
  1. 找到本地 IP 地址。
  2. 更新 .env 文件，設置 ANKI_CONNECT_URL=http://YOUR_LOCAL_IP:8765。
  3. 確保 AnkiConnect 允許來自該 IP 的連接。
  4. 修改後重啟 MCP 服務器。

開發模式

使用熱重載運行服務器：

npm run dev

或在測試模式下開發：

npm run dev:test

📄 許可證

本項目採用 MIT 許可證。