Clanki - Claude 的 Anki 集成

一个 MCP 服务器，使像 Claude 这样的人工智能助手能够通过模型上下文协议 (MCP) 与 Anki 抽认卡牌组进行交互。

特性

• 创建和管理 Anki 牌组
• 创建带有正面/背面内容的基础抽认卡
• 创建完形填空卡片
• 更新现有卡片和完形填空
• 添加和管理标签
• 查看牌组内容和卡片信息
• 与 AnkiConnect 完全集成

前提条件

• 已安装并运行 Anki
• 已在 Anki 中安装 AnkiConnect 插件
• Node.js 16 或更高版本

安装

1. 克隆此存储库：

git clone https://github.com/yourusername/clanki.git
cd clanki

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

设置

1. 确保 Anki 正在运行并且 AnkiConnect 插件已安装并启用

2. 配置 Claude for Desktop 以使用服务器，方法是编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "clanki": {
      "command": "node",
      "args": ["/absolute/path/to/clanki/build/index.js"]
    }
  }
}

将 /absolute/path/to/clanki 替换为 clanki 安装的实际路径。

可用工具

create-deck

创建一个新的 Anki 牌组

• 参数：
  • name: 新牌组的名称

create-card

在指定的牌组中创建一个新的基础抽认卡

• 参数：
  • deckName: 要将卡片添加到的牌组的名称
  • front: 卡片的正面内容
  • back: 卡片的背面内容
  • tags: (可选) 卡片的标签数组

create-cloze-card

在指定的牌组中创建一个新的完形填空卡片

• 参数：
  • deckName: 要将卡片添加到的牌组的名称
  • text: 包含使用 {{c1::text}} 语法的完形填空的文本
  • backExtra: (可选) 在卡片背面显示的额外信息
  • tags: (可选) 卡片的标签数组

update-card

更新现有的基础抽认卡

• 参数：
  • noteId: 要更新的笔记的 ID
  • front: (可选) 新的正面内容
  • back: (可选) 新的背面内容
  • tags: (可选) 卡片的新标签

update-cloze-card

更新现有的完形填空卡片

• 参数：
  • noteId: 要更新的笔记的 ID
  • text: (可选) 带有完形填空的新文本
  • backExtra: (可选) 背面的新额外信息
  • tags: (可选) 卡片的新标签

开发

要修改或扩展服务器：

1. 对 src/index.ts 进行更改
2. 使用 npm run build 重新构建
3. 使用 npx @modelcontextprotocol/inspector node build/index.js 进行调试