Anki Cards (Clanki)

🚀 Clanki - 与Claude集成的Anki插件

Clanki是一个MCP服务器，它允许像Claude这样的AI助手借助模型上下文协议（MCP），与Anki闪卡库进行交互，为用户提供更智能的卡片管理体验。

✨ 主要特性

• 创建和管理Anki卡片库，方便用户组织学习内容。
• 创建基本的前后式卡片，满足常规的学习需求。
• 创建带删除功能的Cloze卡片，增加学习的趣味性和挑战性。
• 更新现有卡片及Cloze删除项，使卡片内容始终保持最新。
• 添加和管理标签，便于对卡片进行分类和检索。
• 查看卡片库内容及卡片信息，让用户随时了解学习进度。
• 完全集成于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 Desktop使用该服务器：

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

在指定卡片库中创建一张新的Cloze删除式卡片。

• 参数：
  • deckName: 卡片所属卡片库的名称。
  • text: 包含Cloze删除语法{{c1::text}}的文本内容。
  • backExtra: (可选) 卡片背面显示的额外信息。
  • tags: (可选) 卡片的标签数组。

update - card

更新一张现有的基本闪卡。

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

update - cloze - card

更新一张现有的Cloze删除式卡片。

• 参数：
  • noteId: 要更新的笔记ID。
  • text: (可选) 新的包含Cloze语法的文本内容。
  • backExtra: (可选) 新的背面额外信息。
  • tags: (可选) 新的标签数组。

🔧 技术细节

开发指南

要修改或扩展服务器：

1. 修改src/index.ts文件。
2. 使用npm run build重新构建项目。
3. 使用npx @modelcontextprotocol/inspector node build/index.js进行调试。