Anki MCP Server

Anki MCP Server

site icon
2025.03.18 1
JavaScript闪卡管理学习工具开发效率
Anki MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,它使大型语言模型(LLMs)能够通过 AnkiConnect API 与 Anki 闪卡软件进行交互。该服务器提供了创建新卡片组、添加笔记、搜索笔记等功能,适用于需要自动化管理 Anki 闪卡的用户。
View on GitHub

Overview

基本能力

产品定位

Anki MCP Server 是一个中间件,旨在通过 MCP 协议连接大型语言模型和 Anki 闪卡软件,实现自动化管理闪卡的功能。

核心功能

  • 创建新的卡片组
  • 向现有卡片组添加笔记
  • 列出可用的卡片组和笔记模型
  • 使用 Anki 的搜索语法搜索笔记
  • 获取笔记模型及其字段的详细信息
  • 批量添加多个笔记

适用场景

  • 自动化生成和管理 Anki 闪卡
  • 批量导入数据到 Anki
  • 通过编程方式查询和修改 Anki 闪卡内容

工具列表

  • listDecks: 获取 Anki 中所有卡片组的列表
  • listModels: 获取 Anki 中所有笔记模型/类型的列表
  • createDeck: 在 Anki 中创建新卡片组
  • getModel: 获取特定笔记模型/类型的详细信息
  • addNote: 向卡片组添加单个笔记
  • addNotes: 一次性添加多个笔记
  • searchNotes: 使用 Anki 的搜索语法搜索笔记

常见问题解答

  1. 无法连接到 Anki
  2. 确保 Anki 正在运行
  3. 检查 AnkiConnect 插件是否已安装并正常工作
  4. 验证 AnkiConnect URL 是否正确(默认:http://localhost:8765)

  5. AnkiConnect 的权限问题

  6. AnkiConnect 可能会在服务器尝试添加卡片时提示权限请求。请在 Anki 中查找弹出窗口。

使用教程

使用依赖

  • Node.js (v14 或更高版本)
  • Anki 并安装 AnkiConnect 插件
  • 一个支持 Model Context Protocol 的客户端(如 Claude with Anthropic MCP support)

安装教程

  1. 确保已安装 Anki 并安装了 AnkiConnect 插件
  2. 通过 工具 > 插件 > 获取插件 并输入代码: 2055492159 安装 AnkiConnect

  3. 克隆仓库: git clone https://github.com/yourusername/anki-mcp-server.git cd anki-mcp-server

  4. 安装依赖: npm install

  5. 构建项目: npm run build

调试方式

  1. 确保 Anki 正在运行且 AnkiConnect 已启用

  2. 启动 MCP 服务器: npm start

  3. 将你的 MCP 客户端(如 Claude)连接到该服务器

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。