Anki MCP

🧠 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 ：高效的包管理器

特别感谢yanki-connect库提供强大的 AnkiConnect 接口来支持此集成！

📋 先决条件

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 卡组”或“用 5 张卡牌测试我”

**💡 专业提示：您可以通过向 Claude 询问一些简单的问题来测试您的设置，例如“我有多少个 Anki 牌组？”或“我最大的牌组里有什么？”

选项 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 对话改变你的抽认卡体验！🚀