Anki MCP Server

Anki MCP Server

site icon
2025.04.04 0
JavaScript学习辅助卡片管理开发效率
Anki MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,专为 Claude Desktop 设计,通过 AnkiConnect 与 Anki 连接,用于检索带有 'leech' 标签的卡片。该服务器提供卡片数据分析功能,帮助用户优化学习过程。
View on GitHub

Overview

基本能力

产品定位

Anki MCP Server 是一个连接 Anki 和 Claude Desktop 的中间件服务,专注于学习卡片的管理和分析。

核心功能

  • 通过 AnkiConnect API 连接 Anki
  • 检索带有 "leech" 标签的卡片
  • 为卡片添加带有时间戳的复习标签
  • 提供全面的卡片数据供 Claude 分析
  • 可与 Claude Desktop 配合使用

适用场景

  • 学习效率分析
  • 复习卡片管理
  • 学习进度跟踪

工具列表

  1. get_leech_cards
  2. 功能:从 Anki 中检索标记为 leech 的卡片
  3. 参数:

    • detailed (可选,布尔值,默认 true):是否返回详细的卡片数据
    • count (可选,数字):返回的随机卡片数量(默认返回所有卡片)
  4. tag_reviewed_cards

  5. 功能:为指定卡片添加带有时间戳的 "reviewed" 标签
  6. 参数:
    • card_ids (必需,数字数组):要标记为已复习的卡片 ID 数组
    • custom_tag_prefix (可选,字符串,默认 "見直し"):自定义标签前缀

常见问题解答

  • "Could not connect to Anki":确保 Anki 正在运行且 AnkiConnect 已正确安装
  • "No leech cards found":Anki 中没有标记为 "leech" 的卡片
  • Connection issues with localhost:使用本地 IP 地址而非 localhost 连接
  • Tag not appearing:确保提供有效的卡片 ID

使用教程

使用依赖

  1. 安装并运行 Anki
  2. 在 Anki 中安装 AnkiConnect 插件
  3. 安装 Node.js 和 npm

安装教程

  1. 克隆仓库: git clone https://github.com/yourusername/anki-mcp-server.git cd anki-mcp-server
  2. 安装依赖: npm install
  3. 构建项目: npm run build

调试方式

  1. 确保 Anki 正在运行且 AnkiConnect 已安装
  2. 运行 MCP 服务器: npm start
  3. 测试模式(不实际影响 Anki 数据): npm run start:test

许可证

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