Nailuogg Anki MCP Server

🚀 Anki MCP 服務器

Anki MCP 服務器是一個基於模型上下文協議（MCP）的服務器，它讓大語言模型能夠藉助 AnkiConnect 與 Anki 翻牌軟件進行交互，極大地拓展了 Anki 的使用場景和功能。

🚀 快速開始

在使用 Anki MCP 服務器之前，你需要完成以下先決條件的準備：

1. 安裝Anki。
2. 在 Anki 中安裝AnkiConnect插件。

✨ 主要特性

工具

• list_decks - 列出所有可用的 Anki 牌組。
• create_deck - 創建一個新的 Anki 牌組。
• create_note - 創建新的筆記（基本或刪除型）。
• batch_create_notes - 一次性創建多條筆記。
• search_notes - 使用 Anki 查詢語法搜索筆記。
• get_note_info - 獲取筆記的詳細信息。
• update_note - 更新現有的筆記。
• delete_note - 刪除一條筆記。
• list_note_types - 列出所有可用的筆記類型。
• create_note_type - 創建新的筆記類型。
• get_note_type_info - 獲取特定筆記類型的結構信息。

資源

• anki://decks/all - 所有可用牌組的完整列表。
• anki://note-types/all - 所有可用筆記類型的列表。
• anki://note-types/all-with-schemas - 所有筆記類型的詳細結構信息。
• anki://note-types/{modelName} - 特定筆記類型的詳細結構信息。

📦 安裝指南

與Claude Desktop一起使用

將服務器添加到claude_desktop_config.json：

{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes","anki-mcp-server"]
    }
  }
}

Cline的配置

將服務器添加到 VSCode 設置中的cline_mcp_settings.json文件：

{
  "mcpServers": {
    "anki": {
      "command": "npx",
      "args": ["--yes","anki-mcp-server"]
    }
  }
}

💻 使用示例

基礎用法

1. 創建一個新的牌組：

創建一個名為“編程”的新 Anki 牌組

2. 添加一張基本卡片：

在“編程”牌組中創建一張新的卡片，正面為：“JavaScript 中的閉包是什麼？”，背面為：“閉包是函數和變量的組合，能夠保留其作用域。”

3. 添加一張刪除型卡片：

在“編程”牌組中創建一條新的刪除型卡片，問題為：“JavaScript 中的閉包如何使用？”，答案為：“通過將函數定義在另一個函數內部，並捕獲外部函數的變量來實現。”

🔧 技術細節

設置

1. 安裝依賴：

npm install

2. 構建服務器：

npm run build

3. 開發時自動重建：

npm run watch

測試

運行測試套件：

npm test

這將執行以下內容的測試：

• 服務器初始化。
• AnkiConnect 通信。
• 筆記操作（創建/讀取/更新/刪除）。
• 牌組管理。
• 錯誤處理。

調試

由於 MCP 服務器通過標準輸入輸出進行通信，我們推薦使用MCP 檢查器：

npm run inspector

這將提供一個基於瀏覽器的界面用於：

• 監控 MCP 消息。
• 測試工具調用。
• 查看服務器日誌。
• 調試通信問題。

📄 許可證

項目採用MIT 許可證，具體條款如下：

(此處應包含完整的 MIT 許可證文本)

🤝 貢獻指南

• 代碼提交時請遵循Contributing.md文件中的規範。
• 提交問題或建議到Issues 頁面。