Anki MCP 服务器

一个模型上下文协议 (MCP) 服务器，它使 LLM 能够通过 AnkiConnect API 与 Anki 抽认卡软件进行交互。

功能

• 在 Anki 中创建新牌组
• 将笔记添加到现有牌组
• 列出可用的牌组和笔记模型
• 使用 Anki 的搜索语法搜索笔记
• 获取有关笔记模型及其字段的详细信息
• 一次批量添加多个笔记

前提条件

• Node.js (v14 或更高版本)
• 安装了 AnkiConnect 插件的 Anki
• 兼容模型上下文协议的客户端（例如，支持 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: 在 Anki 中创建一个新牌组
• getModel: 获取有关特定笔记模型/类型的详细信息
• addNote: 向牌组添加单个笔记
• addNotes: 一次添加多个笔记
• searchNotes: 使用 Anki 的搜索语法搜索笔记

示例

创建一个新牌组

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

添加一个笔记

{
  "name": "addNote",
  "arguments": {
    "deckName": "My New Deck",
    "modelName": "Basic",
    "fields": {
      "Front": "法国的首都是什么？",
      "Back": "巴黎"
    },
    "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 可能会提示您授予权限。 在 Anki 中查找弹出窗口。

许可证

MIT 许可证