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) 连接到此服务器

可用工具

该服务器为 MCP 客户端提供的以下工具:

• listDecks: 获取 Anki 中所有牌组的列表
• listModels: 获取 Anki 中所有笔记模板/类型的列表
• createDeck: 创建新的牌组
• getModel: 获取特定笔记模板/类型的详细信息
• addNote: 向牌组中添加单条笔记
• addNotes: 一次添加多条笔记
• searchNotes: 使用 Anki 的搜索语法搜索笔记

示例

创建新牌组

{
  "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"
  }
}

配置

服务器配置位于 src/index.ts 中的 config 对象。您可以修改以下内容:

• ankiConnectUrl: AnkiConnect API 的 URL (默认: http://localhost:8765)
• apiVersion: AnkiConnect API 版本 (默认: 6)
• defaultDeckName: 未指定时使用的默认牌组名称 (默认: Default)

故障排除

1. 无法连接到 Anki

   • 确保 Anki 已运行
   • 检查 AnkiConnect 插件是否已安装且正常工作
   • 验证 AnkiConnect URL 是否正确 (默认: http://localhost:8765)

2. AnkiConnect 权限问题

   • 当服务器尝试添加卡片时，AnkiConnect 可能会提示权限请求。请确保允许相关权限

通过以上步骤，您可以使用此 MCP 服务器与 Anki 实现 LLM 交互功能。