SuperAPI AI 工具集

anki-mcp

anki-mcp 是一个基于模型上下文协议(MCP)的服务器,用于通过 AnkiConnect 插件与 Anki 闪卡进行交互。它将 AnkiConnect 的操作暴露为 MCP 工具,并按逻辑服务分组,方便 AI 助手或 MCP 客户端调用。使用前需安装 Anki 桌面应用并配置 AnkiConnect 插件,推荐使用 uv 运行。服务器默认连接 http://127.0.0.1:8765。提供牌组、笔记、卡片、模型(笔记类型)和媒体等服务的工具,涵盖创建、查询、修改、删除等功能。可通过 MCP Inspector 查看工具,并配置到 MCP 客户端中。

访问官网

工具介绍

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)、删除指定媒体文件等。

使用方式 使用前需满足以下条件:

  1. 安装 Anki 桌面应用。
  2. 在 Anki 中安装并配置 AnkiConnect 插件。
  3. 可选但推荐:安装 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 工具。
  • 具体安装步骤、配置示例及依赖版本等细节暂未提供完整信息。