Anki MCP Server

Anki MCP Server

site icon
2025.03.24 0
TypeScript闪卡管理自动化工具开发效率
Anki MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,它允许大型语言模型(LLMs)通过 AnkiConnect 与 Anki 闪卡软件进行交互。该服务器提供了一系列工具和资源,用于管理 Anki 的牌组、笔记和笔记类型,使得自动化创建、查询、更新和删除闪卡成为可能。
View on GitHub

Overview

基本能力

产品定位

Anki MCP Server 是一个桥接服务,使得 LLMs 能够通过 MCP 协议与 Anki 闪卡软件进行交互,主要用于自动化管理和操作 Anki 闪卡。

核心功能

  • 牌组管理:列出所有可用的牌组,创建新的牌组。
  • 笔记操作:创建、搜索、获取信息、更新和删除笔记,支持基本和填空类型的笔记。
  • 批量操作:支持批量创建笔记。
  • 笔记类型管理:列出所有可用的笔记类型,创建新的笔记类型,获取笔记类型的详细信息。

适用场景

  • 自动化创建和管理 Anki 闪卡。
  • 批量导入或更新闪卡内容。
  • 通过 LLMs 生成闪卡内容并直接导入到 Anki 中。

工具列表

  • list_decks:列出所有可用的 Anki 牌组。
  • create_deck:创建一个新的 Anki 牌组。
  • create_note:创建一个新的笔记(基本或填空类型)。
  • batch_create_notes:一次性创建多个笔记。
  • search_notes:使用 Anki 查询语法搜索笔记。
  • get_note_info:获取笔记的详细信息。
  • update_note:更新现有的笔记。
  • delete_note:删除笔记。
  • list_note_types:列出所有可用的笔记类型。
  • create_note_type:创建一个新的笔记类型。
  • get_note_type_info:获取笔记类型的详细结构。

常见问题解答

  • 如何调试:推荐使用 MCP Inspector 进行调试,可以监控 MCP 消息、测试工具调用、查看服务器日志和调试通信问题。

使用教程

使用依赖

  1. 安装 Anki 到你的系统。
  2. 在 Anki 中安装 AnkiConnect 插件。

安装教程

  1. 安装依赖:
npm install
  1. 构建服务器:
npm run build
  1. 开发时自动重建:
npm run watch

调试方式

使用 MCP Inspector 进行调试:

npm run inspector

示例用法

  1. 创建一个新的牌组:
Create a new Anki deck called "Programming"
  1. 添加一个基本卡片:
Create an Anki card in the "Programming" deck with:
Front: What is a closure in JavaScript?
Back: A closure is the combination of a function and the lexical environment within which that function was declared.
  1. 添加一个填空卡片:
Create a cloze card in the "Programming" deck with:
Text: In JavaScript, {{c1::const}} declares a block-scoped variable that cannot be {{c2::reassigned}}.

许可证

该项目遵循 MIT 开源许可条款。