Anki MCP Server

🚀 Anki MCP 服務器

Anki MCP 服務器是一個支持大語言模型（LLM）與 Anki 理解卡片軟件交互的模型上下文協議（MCP）服務器，它藉助 AnkiConnect API 實現了兩者之間的通信，為用戶提供了便捷的卡片管理和交互方式。

✨ 主要特性

• 牌組管理：可以創建新的牌組，還能列出所有可用的牌組。
• 筆記操作：將筆記添加到現有的牌組中，支持一次批量添加多個筆記，也能使用 Anki 的搜索語法搜索筆記。
• 模板信息：列出所有可用的筆記模板，並獲取筆記模板及其字段的詳細信息。

📦 安裝指南

先決條件

• Node.js（版本 14 或更高）
• 安裝了 Anki 並安裝了 AnkiConnect 插件
• 具備模型上下文協議兼容客戶端（例如支持 Anthropic MCP 的 Claude）

安裝步驟

1. 確保已安裝 Anki 並啟用 AnkiConnect 插件：
   • 通過“工具”>“插件”>“獲取插件”，輸入代碼：2055492159 來安裝 AnkiConnect。
2. 克隆此倉庫：

   git clone https://github.com/yourusername/anki-mcp-server.git
   cd anki-mcp-server
   

3. 安裝依賴項：

   npm install
   

4. 構建項目：

   npm run build
   

💻 使用示例

基礎用法

啟動服務器

1. 確保 Anki 已運行且 AnkiConnect 啟用。
2. 啟動 MCP 服務器：

   npm start
   

3. 將您的 MCP 客戶端（例如 Claude）連接到此服務器。

示例請求

創建新牌組

{
  "name": "createDeck",
  "arguments": {
    "name": "My New Deck"
  }
}

添加一條筆記

{
  "name": "addNote",
  "arguments": {
    "deckName": "My New Deck",
    "modelName": "Basic",
    "fields": {
      "Front": "What is the capital of France?",
      "Back": "Paris"
    },
    "tags": ["geography", "europe"]
  }
}

搜索筆記

{
  "name": "searchNotes",
  "arguments": {
    "query": "deck:\"My New Deck\" tag:geography"
  }
}

📚 詳細文檔

可用工具

該服務器為 MCP 客戶端提供了以下工具：

配置

服務器配置位於 src/index.ts 中的 config 對象。您可以修改以下內容：

故障排除

無法連接到 Anki

• 確保 Anki 已運行。
• 檢查 AnkiConnect 插件是否已安裝且正常工作。
• 驗證 AnkiConnect URL 是否正確（默認：http://localhost:8765）。

AnkiConnect 權限問題

當服務器嘗試添加卡片時，AnkiConnect 可能會提示權限請求。請確保允許相關權限。

通過以上步驟，您可以使用此 MCP 服務器與 Anki 實現 LLM 交互功能。