🧠 Anki MCP

用人工智能改变你的 Anki 抽认卡体验！这款MCP（模型上下文协议）服务器将你的 Anki 抽认卡集与 Claude 等人工智能助手连接起来，让你能够自然地讨论你的学习资料。

🚀你能做什么？

想象一下，有一位 AI 导师了解你的全部抽认卡，并且可以：

📚互动学习

• “考考我三天没见过的日语词汇”

• “用我医疗卡组中的挑战卡来测试我”

• “给我看看我最近遇到困难的卡片”

✨智能内容创作

• “用图表制作关于光合作用的抽认卡”

• “将此 PDF 章节转换为间隔重复卡片”

• “从我的课堂笔记中生成完形填空卡”

🔍强大的分析功能

• “我最难理解的是哪些主题？”

• “显示我上个月的学习模式”

• “不同类型的卡的留存率是多少？”

🎯批量操作

• “给我所有的化学卡片都贴上‘备考’的标签”

• “将留存率低的卡片移至密集复习卡组”

• “查找并修复我牌组中的重复卡牌”

🎯 功能

• 完全 Anki 集成：通过所有 115 种 AnkiConnect API 方法完全访问卡片组、卡片、笔记和统计数据

• 对话界面：通过人工智能助手发出自然语言命令

• 批量操作：同时高效管理数千张卡

• 实时统计：了解您的学习进度

• 媒体支持：处理卡片中的图像、音频和其他媒体

• 高级查询：使用复杂的搜索条件查找卡片

• 类型安全：具有全面错误处理的全类型 API

🛠 技术栈

• Node.js ：运行环境（要求 18+）

• TypeScript ：类型安全和开发者体验

• MCP SDK ：模型上下文协议实现

• yanki-connect ：🙏全类型、同构的 AnkiConnect API 客户端

• tsup ：快速 TypeScript 打包器

• PNPM ：高效的包管理器

特别感谢

📋 先决条件

1.安装Anki

如果尚未下载并安装Anki ，请下载并安装。

2.安装AnkiConnect插件

1. 打开 Anki

2. 转到工具→附加组件

3. 单击获取附加组件...

4. 输入代码： 2055492159

5. 重启 Anki

**📋 版本要求：**本服务器需要 AnkiConnect 25.2.25.0 或更新版本（发布于 2025-02-25）才能完全兼容。大多数功能可在旧版本中使用，但我们建议您更新以获得最佳体验。

3.配置 AnkiConnect（可选）

AnkiConnect 开箱即用，但您可以自定义设置：

1. 转到工具→附加组件

2. 选择AnkiConnect并点击配置

3. 默认设置应该适合大多数用户

🚀 快速入门

选项 1：与 Claude Desktop 一起使用（推荐）

1. 安装包

   npm install -g @arielbk/anki-mcp

2. 配置 Claude 桌面

   编辑您的 Claude Desktop 配置文件：

   macOS ： ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows ： %APPDATA%\Claude\claude_desktop_config.json

   添加此配置：

   { "mcpServers": { "anki": { "command": "anki-mcp", "args": [] } } }

3. 重启Claude桌面

4. 开始使用它！

   • 确保 Anki 正在运行并且启用了 AnkiConnect

   • 询问 Claude： “给我看看我的 Anki 卡组”

**💡 专业提示：您可以通过向 Claude 询问一些简单的问题来测试您的设置，例如

选项 2：开发设置

1. 克隆存储库

   git clone https://github.com/arielbk/anki-mcp.git cd anki-mcp

2. 安装依赖项

   pnpm install

3. 构建项目

   pnpm build

4. 测试服务器

   # Use the MCP inspector to test functionality pnpm inspect

选项 3：与其他 MCP 客户端一起使用

此服务器可与任何兼容 MCP 的客户端配合使用。您还可以将其用于：

• MCP Inspector ：交互式调试工具

• Cline ：用于 AI 编码的 VS Code 扩展

• 自定义 MCP 客户端：使用MCP SDK构建您自己的客户端

对于 stdio 传输，运行：

🎮 使用示例

一旦配置了 Claude Desktop，您就可以进行自然的对话，例如：

📖 学习课程

📝 内容创作

📊 学习分析

🏷️ 组织

🔧 可用的工具和资源

该 MCP 服务器通过以下功能提供对您的 Anki 集合的全面访问：

📚牌组管理

• 列出所有带有统计数据的卡组

• 创建新牌组

• 重命名和删除卡组

• 获取甲板配置

🗂️卡片操作

• 按搜索条件查找卡片

• 答题卡（模拟复习）

• 获取卡信息和统计数据

• 暂停/取消暂停卡

• 批量卡操作

📝笔记管理

• 使用自定义字段添加新注释

• 更新现有笔记

• 删除笔记

• 通过搜索查询查找笔记

• 批量票据操作

📊统计与分析

• 牌组统计数据和性能指标

• 卡片难易度和间隔数据

• 回顾历史和模式

• 学习进度洞察

🎨媒体与模特

• 访问注释类型和字段定义

• 媒体文件管理

• 模板定制支持

🔍高级功能

• 使用 Anki 搜索语法的复杂搜索查询

• 批量操作以提高效率

• 与Anki实时同步

• 错误处理和验证

• 按功能分组的组织 API 方法（卡片、卡组、注释、模型、统计数据、媒体等）

• 直接访问所有 115 个 AnkiConnect API 方法，并具有完全类型安全性

🛠 开发

🔧 配置

AnkiConnect 设置

服务器默认连接到localhost:8765上的 AnkiConnect。如果你自定义了 AnkiConnect 配置，则可能需要调整连接设置。

重要提示：使用 MCP 服务器前，请确保 Anki 已运行且 AnkiConnect 已安装。如果 AnkiConnect 无法访问，服务器将无法连接。

**💡 注意：**底层 yanki-connect 库支持在 macOS 上自动启动 Anki，但此功能目前尚未在 MCP 服务器配置中公开。您需要手动启动 Anki。

Claude Desktop高级配置

对于高级用户，您可以传递额外的参数：

故障排除

常见问题：

• “无法连接到 AnkiConnect” ：确保 Anki 正在运行并且 AnkiConnect 插件已安装

• “未找到牌组” ：请确保 Anki 中至少有一个牌组

• Claude 没有响应：配置更改后重新启动 Claude Desktop

• 权限错误：检查全局 npm install 是否与npm list -g @arielbk/anki-mcp正确运行

🤝 贡献

欢迎投稿！请：

1. 分叉存储库

2. 创建功能分支

3. 进行更改

4. 如果适用，添加测试

5. 提交拉取请求

📜 许可证

MIT——详情请参阅LICENSE文件。

🙏 致谢

• yanki-connect - AnkiConnect 的优秀 TypeScript 客户端

• AnkiConnect - 使 Anki 自动化成为可能的插件

• 模型上下文协议——实现无缝 AI 集成

利用 AI 对话改变你的抽认卡体验！🚀