Anki MCP 服务器

一个模型上下文协议 (MCP) 服务器，使 LLM 能够通过 AnkiConnect 与 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 - 获取笔记类型的详细结构

资源

• 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 配置文件 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. 添加一张完形填空卡片：

在“Programming”卡组中创建一张完形填空卡片，内容如下：
文本：在 JavaScript 中，{{c1::const}} 声明一个块级作用域变量，该变量不能被 {{c2::重新赋值}}。

贡献

1. Fork 仓库
2. 创建您的功能分支
3. 运行测试：npm test
4. 提交 Pull Request

鸣谢

图标由 macOS Icons 提供

许可证

MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件