Anki MCP 服务器

一个 Model Context Protocol (MCP) 服务器，通过 AnkiConnect 使 LLM 能够与 Anki 闪卡软件进行交互。

功能

工具

• list_decks - 列出所有可用的 Anki 卡组
• create_deck - 创建一个新的 Anki 卡组
• create_note - 创建一个新的笔记（基本或 Cloze）
• batch_create_notes - 一次创建多个笔记
• search_notes - 使用 Anki 查询语法搜索笔记
• get_note_info - 获取有关笔记的详细信息
• update_note - 更新现有笔记
• delete_note - 删除笔记
• list_note_types - 列出所有可用的笔记类型
• create_note_type - 创建新的笔记类型
• get_note_type_info - 获取特定笔记类型的详细结构

资源

• anki://decks/all - 可用卡组的完整列表
• anki://note-types/all - 所有可用笔记类型的列表
• anki://note-types/all-with-schemas - 所有笔记类型的详细结构信息
• anki://note-types/{modelName} - 特定笔记类型的详细结构信息

前提条件

1. 在您的系统上安装 Anki
2. 在 Anki 中安装 AnkiConnect 插件

配置

与 Claude Desktop 一起使用

将服务器添加到您的 claude_desktop_config.json 文件中：

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

Cline 的配置

将服务器添加到 VSCode 设置中的 cline_mcp_settings.json 文件中：

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

开发

设置

1. 安装依赖项：

npm install

2. 构建服务器：

npm run build

3. 开发时自动重建：

npm run watch

测试

运行测试套件：

npm test

这将执行以下测试：

• 服务器初始化
• AnkiConnect 通信
• 笔记操作（创建/读取/更新/删除）
• 卡组管理
• 错误处理

调试

由于 MCP 服务器通过 stdio 通信，我们建议使用 MCP Inspector：

npm run inspector

这提供了一个基于浏览器的界面，用于：

• 监控 MCP 消息
• 测试工具调用
• 查看服务器日志
• 调试通信问题

示例用法

1. 创建一个新的卡组：

创建一个名为 "Programming" 的新 Anki 卡组

2. 添加一个基本卡片：

在 "Programming" 卡组中创建一个 Anki 卡片，内容如下：
正面：JavaScript 中的闭包是什么？
背面：闭包是函数及其声明所在的词法环境的组合。

3. 添加一个 Cloze 删除卡片：

在 "Programming" 卡组中创建一个 Cloze 卡片，内容如下：
文本：在 JavaScript 中，{{c1::const}} 声明一个不能被 {{c2::重新赋值}} 的块级作用域变量。

贡献

1. 分叉仓库
2. 创建您的功能分支
3. 运行测试：npm test
4. 提交拉取请求

致谢

图标由 macOS Icons 提供

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件