anki-mcp 是一个模型上下文协议(MCP)服务器,用于与 Anki 闪卡进行交互。它通过 AnkiConnect 插件将 AnkiConnect 的操作作为 MCP 工具暴露出来,并按逻辑服务进行组织。
用途 该服务器旨在让 AI 助手或其他 MCP 客户端能够通过标准协议管理 Anki 集合,例如创建牌组、添加笔记、查询卡片信息等。
主要能力 服务器提供以下按服务分组的 MCP 工具(工具名称直接对应 AnkiConnect 操作):
- 牌组服务(deck.*):获取牌组名称和 ID 列表、获取牌组配置、创建空牌组、删除牌组、移动卡片到其他牌组、保存牌组配置等。
- 笔记服务(note.*):根据搜索查询查找笔记 ID、获取笔记信息、获取笔记标签、创建新笔记、修改笔记字段、删除笔记、批量创建笔记、添加或移除标签、更新笔记字段和/或标签等。
- 卡片服务(card.*):根据搜索查询查找卡片 ID、获取卡片信息、将卡片 ID 转换为笔记 ID、检查卡片是否被暂停、获取卡片修改时间、暂停或取消暂停卡片、设置单个卡片的特定值(需谨慎使用)等。
- 模型服务(model.*,即笔记类型):获取模型名称和 ID 列表、按名称查找模型定义、获取模型字段名称、获取模型模板内容、获取模型 CSS 样式、创建新模型、修改模型模板、修改模型 CSS 样式、添加或移除模型字段等。
- 媒体服务(media.*):获取媒体文件的 base64 编码内容、按通配模式获取媒体文件名、存储媒体文件(可从 base64、路径或 URL)、删除指定媒体文件等。
使用方式 使用前需满足以下条件:
- 安装 Anki 桌面应用。
- 在 Anki 中安装并配置 AnkiConnect 插件。
- 可选但推荐:安装 uv 用于运行和安装依赖。
运行 MCP 服务器后,服务器将启动并监听 MCP 请求,通常与 AnkiConnect 在 http://127.0.0.1:8765 进行交互。可以使用 MCP Inspector 查看可用工具。若要与 MCP 客户端(如 AI 助手框架)集成,需进行配置以找到此服务器。
适用场景 适用于希望通过 MCP 协议自动化管理 Anki 闪卡的用户,例如在 AI 助手框架中集成 Anki 操作,实现批量创建笔记、查询卡片、管理牌组等任务。
限制
- 需本地运行 Anki 桌面应用和 AnkiConnect 插件。
- 项目仍在开发中,作者提到“Finish adding all AnkiConnect tools”,即尚未添加所有 AnkiConnect 工具。
- 具体安装步骤、配置示例及依赖版本等细节暂未提供完整信息。