Clanki - Claude 的 Anki 集成

一个 MCP 服务器，使像 Claude 这样的 AI 助手能够通过模型上下文协议（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_desktop_config.json 文件以配置桌面版 Claude 使用该服务器：

{
  "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 调试

许可证

本项目采用 MIT 许可证 - 详情见 LICENSE 文件。

贡献

欢迎贡献！请随意提交拉取请求。

致谢

• 使用 Model Context Protocol SDK 构建
• 通过 AnkiConnect 与 Anki 集成