Anki MCP 服务器

一个模型上下文协议（MCP）服务器，使大型语言模型（LLMs）能够通过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. 创建一个新的卡组：

创建一个名为“编程”的新Anki卡组

2. 添加一张基础卡片：

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

3. 添加一张填空卡片：

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

贡献

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

星标历史

致谢

图标由 macOS Icons 提供

许可证

MIT 许可证 - 详见 LICENSE 文件