AI导哈

Anki AI助手

Anki MCP是一个将Anki闪卡与AI助手（如Claude）连接的服务，通过自然语言交互实现智能学习、内容创建和数据分析功能。

  • by arielbk
  • TypeScript
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 arielbk/anki-mcp

使用说明

🧠 Anki MCP（注：Anki MCP可能指的是一种特定的Anki记忆卡片或学习计划，但具体含义需根据上下文确定，此处直译为“Anki MCP”，在实际应用中可能需要进一步解释或翻译为更具体的含义）


用AI改变你的Anki闪卡体验！这 MCP（模型上下文协议） Server将您的Anki记忆卡片集合与Claude等AI助手连接起来，使您能够就学习材料进行自然对话。

🚀 你能做什么？

想象一下，有一个AI导师，它了解你所有的闪卡集合，并且能够：

📚 书籍或学习的象征 互动式学习

  • “考考我那些我三天没见到的日本词汇”
  • “用我医疗牌组里的难题来考考我”
  • “给我看看我最近一直在努力应对的卡片”

✨（星星眼表情，通常表示惊喜、赞叹或调皮） 智能内容创作

  • “制作包含光合作用图解的闪卡”
  • “将这个PDF章节转换成间隔重复卡片”
  • “根据我的讲义生成填空卡片”

🔍 翻译为中文是：放大镜（或用于表示搜索、查看细节等动作的符号）。在实际语境中，这个符号常被用来表示仔细查看、搜索或放大以查看更多细节的意思。 强大的分析能力

  • “我最难以掌握的话题是什么？”
  • “给我展示一下我过去一个月的学习模式”
  • “我不同类型的卡片的留存率是多少？”

🎯（目标/瞄准） 批量操作

  • “给我的所有化学卡片都加上‘考试准备’的标签”
  • “将低留存率的卡片移动到强化复习组”
  • “查找并修复我所有牌组中的重复卡片”

🎯 特点

  • 🎯 智能工具设计专为人工智能代理设计的直观、高级工具
  • 💬 自然对话像和学习伙伴聊天一样，和克劳德聊聊你的记忆卡片
  • ⚡ 极速闪电高效运行，不拖慢您的AI助手
  • 📦 批量操作使用简单命令一次性更新数千张卡片
  • 📊 研究洞察对您的学习进度和模式进行深度分析
  • 🎨 富媒体全面支持卡片中的图片、音频及其他媒体
  • 🔍 强大的搜索功能利用自然语言实现Anki的高级搜索语法
  • 🔒 坚如磐石全面采用类型化的TypeScript，具备完善的错误处理机制

🛠 技术栈

特别感谢 Yanki-Connect（注：此翻译基于假设的“yanki-connect”可能是一个产品或服务的名称，实际翻译可能需根据具体上下文调整） 提供强大AnkiConnect接口以支持此集成的库！

📋 前提条件

1. 安装Anki

下载并安装 Anki（注：Anki是一个用于记忆卡片和学习的软件，直接翻译为“安基”可能无法准确传达其用途，因此在此保留原名） 如果你还没做过的话。

2. 安装AnkiConnect插件

  1. 打开Anki
  2. 首选 工具 → 插件/附加组件
  3. 点击 获取插件。。。
  4. 输入代码： 2055492159
  5. 重启Anki

📋 版本要求： 此服务器要求AnkiConnect版本为25.2.25.0或更高版本（发布于2025年2月25日）以确保完全兼容。大多数功能在旧版本中也能使用，但我们建议更新至最新版本以获得最佳体验。

3. 配置AnkiConnect（可选）

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

  1. 首选 工具 → 插件/附加组件
  2. 选择 AnkiConnect 并点击 配置
  3. 默认设置对大多数用户来说应该都能正常工作

🚀 快速入门

选项1：与Claude桌面版一起使用（推荐）

  1. 安装软件包

    npm install -g @arielbk/anki-mcp

  2. 配置Claude桌面版

    编辑您的Claude桌面配置文件：

    macOS（发音：/ˈmækOS/，中文常译作“麦奥斯”或直接使用原英文名，因其是苹果公司的操作系统，也被称为“苹果电脑操作系统”）: ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

    添加此配置：

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

  3. 重启Claude桌面版

  4. 开始使用它吧！

    • 确保Anki已启用AnkiConnect并正在运行
    • 问克劳德： “给我看看我的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兼容的客户端都能配合使用。您也可以将其与以下工具一起使用：

对于stdio传输，请运行：

node dist/index.js

对于本地主机HTTP（Streamable HTTP）传输，请运行：

node dist/index.js --http --host=127.0.0.1 --port=3000
# The MCP endpoint will be at http://127.0.0.1:3000/mcp

支持Streamable HTTP的客户端可以直接连接。旧版SSE客户端仍可通过客户端回退机制正常工作。

🎮 使用示例

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

📖 学习时段

You: "I have a Japanese exam tomorrow. Can you quiz me on Hiragana cards I haven't reviewed in a week?"

Claude: I'll find your Hiragana cards that need review and start a quiz session...

📝 内容创作

You: "Create flashcards for the major battles of World War II with dates and significance"

Claude: I'll create comprehensive flashcards covering the key WWII battles...

📊 学习分析

You: "How am I doing with my medical terminology deck? Show me my weak areas."

Claude: Let me analyze your performance on the medical terminology deck...

🏷️ 组织

You: "Tag all cards about cardiovascular system with 'cardiology' and move them to my MCAT prep deck"

Claude: I'll help you organize those cards...

🔧 可用工具

服务器提供 7个直观工具 涵盖了您所需的一切：

📝（记事本/笔记） 管理闪卡

创建、更新、删除和搜索您的闪卡。非常适合内容创作、批量更新和组织管理。

🎯（目标、靶心） 学习时段/学习会议

运行互动问答环节，管理卡片安排，并跟踪哪些卡片需要复习。

📚 书籍或书本的符号，常用于表示阅读、学习或书籍相关的主题。 管理卡组

创建并整理牌组，移动卡片，并配置牌组设置。

📊（表格） 获取分析数据

深入研究你的学习统计数据、历史记录和学习模式。

🎨（颜料/艺术创作的颜料） 管理模型

自定义笔记类型，添加字段，修改模板，并为您的卡片设置样式。

🔧（扳手，象征修理或技术） Anki运营（或Anki操作）

处理同步、媒体文件、导入/导出以及其他实用操作。

🖼️ 获取媒体文件

从你的Anki收藏中检索媒体文件（图片、音频等）。AI助手可以直接分析图片（尽管它们不会在用户界面上显示）。

💡 小贴士： 许多操作支持分页，以防止您的上下文窗口被信息淹没。请使用 limit 和 offset 在处理大型结果集时的参数。

🛠 开发

# Run in development mode with auto-reloading
pnpm dev

# Lint the code
pnpm lint

# Format the code
pnpm format

# Test with MCP inspector
pnpm inspect

🔧 配置

AnkiConnect 设置

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

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

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

Claude Desktop 高级配置

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

{
  "mcpServers": {
    "anki": {
      "command": "anki-mcp",
      "args": ["--verbose"],
      "env": {
        "ANKI_CONNECT_HOST": "localhost",
        "ANKI_CONNECT_PORT": "8765"
      }
    }
  }
}

故障排除

常见问题：

  • **“无法连接到AnkiConnect”**确保Anki正在运行，并且已安装AnkiConnect插件
  • **“未找到卡组”**确保你至少在Anki中有一个卡片组
  • 克劳德没有回应配置更改后重启Claude桌面版
  • 权限错误检查全局 npm 安装是否成功执行 npm list -g @arielbk/anki-mcp

🤝 贡献（或：参与贡献）

我们欢迎投稿！请：

  1. 为仓库创建分支
  2. 创建一个特性分支
  3. 做出你的更改
  4. 如适用，请添加测试
  5. 提交一个拉取请求

📜 许可证

MIT - 参见 许可证 文件中有详细信息。

🙏 致谢

用AI驱动的对话，彻底改变你的记忆卡片体验！ 🚀（火箭/快速上升/加速的符号，根据上下文可具体翻译为“火箭发射”、“快速上升”或“加速”等）

相关 MCP