关于 Anki MCP Server
连接 AI 助手与 Anki 的 MCP 服务,适用于管理卡片、笔记和复习信息。除批量添加或更新笔记外,还提供搜索、卡片状态操作及搜索语法文档资源。
主要功能
- 01查看牌组、笔记类型和字段
- 02批量添加或更新笔记
- 03按日期统计复习卡片
- 04使用 Anki 语法搜索笔记和卡片
- 05暂停或恢复卡片
- 06提供搜索语法文档资源
适用场景
- 01批量创建或更新学习笔记
- 02查找符合条件的笔记或卡片
- 03统计每日复习卡片数量
- 04暂停或恢复指定卡片
MCP 相关
MCP 服务通过工具和 `anki://docs/search-syntax` 资源向客户端提供 Anki 集合查询与管理能力。它要求 Anki 和 AnkiConnect 插件运行。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Anki MCP 服务
一个模型上下文协议(MCP)服务,用于将 AI 助手与 Anki 集成。Anki 是一款广受欢迎的间隔重复闪卡软件。
功能
此 MCP 服务可让 AI 助手通过以下工具与 Anki 交互:
工具
-
get-collection-overview:返回 Anki 集合的概览,例如可用的牌组、笔记类型及其字段
-
add-or-update-notes:添加新笔记或更新现有笔记。支持一次批量添加或更新多条笔记。
-
get-cards-reviewed:获取每天复习的卡片数量
-
find-notes:使用 Anki 搜索语法查询笔记
-
find-cards:在 Anki 中查找符合查询条件的卡片 ID
-
suspend-cards:按卡片 ID暂停卡片
-
unsuspend-cards:按卡片 ID取消暂停卡片
资源
- anki://docs/search-syntax:Anki 搜索查询语法的综合参考指南。包含基本运算符、字段搜索、标签、牌组、卡片状态、属性、时间、ID、自定义数据和高级查询示例。此资源提供与语言无关的文档,可帮助任何人使用 find-notes 或 find-cards 工具构造搜索查询
要求
- 必须安装并运行 Anki
- 必须在 Anki 中安装并运行 AnkiConnect 插件
- 此 MCP 服务使用
uv。要安装uv,请按照官方说明操作。
安装
作为 Claude Code 插件安装(推荐)
作为插件安装,一步即可同时获取 MCP 服务和语言学习技能:
/plugin install anki-mcp
手动设置 Claude Code
-
添加 MCP 服务:
claude mcp add anki -- uvx anki-mcp -
(可选)将
skills/中的技能文件复制到项目的.claude/skills/目录,以获取语言学习指导。
Claude Desktop
-
打开 Claude Desktop 配置文件:
- macOS:
~/Library/Application\ Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%/Claude/claude_desktop_config.json
- macOS:
-
将
anki-mcp添加到mcpServers部分:"mcpServers": { "anki": { "command": "uvx", "args": ["anki-mcp"] } } -
重启 Claude Desktop。
仅安装 MCP 服务
对于其他兼容 MCP 的客户端,可直接运行服务:
uvx anki-mcp
语言学习技能
此插件包含一项配套技能,提供制作高效语言学习闪卡的最佳实践。作为插件安装后,此技能会自动启用。技能内容包括:
- 推荐的卡片创建工作流
- 卡片质量指南(长度、内容、完形填空用法)
- 笔记类型多样性建议
- 优质与劣质卡片示例
- 熟练度等级指南(CEFR A1-C2)
MCP 服务可独立于此技能运行,因此你可以将其用于任何 Anki 工作流,而不仅限于语言学习。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。