anki-mcp MCP Server

anki-mcp MCP Server

site icon
2025.03.20 37
JavaScript学习工具Anki 集成开发效率
anki-mcp-server 是一个基于 TypeScript 的 MCP 服务器,通过 AnkiConnect 插件与 Anki 集成。它展示了核心 MCP 概念,提供了管理 Anki 卡组和笔记模型的功能,包括通过 URI 访问资源、创建和管理笔记的工具,以及与 AnkiConnect API 的集成。
View on GitHub

Overview

基本能力

产品定位

anki-mcp-server 是一个用于与 Anki 集成的 MCP 服务器,主要用于管理和操作 Anki 的学习卡片和卡组。

核心功能

  • 资源管理
  • 通过 anki://decks/{id} URI 列出和访问 Anki 卡组
  • 通过 anki://models/{id} URI 列出和访问笔记模型
  • 提供 Anki 对象的 JSON 表示

  • 工具功能

  • listDecks:获取所有卡组的名称
  • listModels:获取所有笔记模型的名称
  • getModel:获取特定笔记模型的详细信息
  • addNote:创建单个笔记,可指定卡组名称、模型名称、字段和标签
  • addNotes:批量创建多个笔记

适用场景

  • 需要与 Anki 集成的自动化学习工具
  • 批量创建和管理 Anki 笔记
  • 开发与 Anki 相关的学习应用

使用教程

使用依赖

安装 Node.js 和 npm。

安装教程

  1. 克隆项目并安装依赖:
npm install
  1. 构建服务器:
npm run build
  1. 开发时自动重建:
npm run watch
  1. 配置 Claude Desktop 使用该服务器:
  2. MacOS: 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json
  3. Windows: 编辑 %APPDATA%/Claude/claude_desktop_config.json 添加以下配置:
{
  "mcpServers": {
    "anki-mcp": {
      "command": "node",
      "args": ["d:\\anki-mcp-server\\build\\index.js"]
    }
  }
}

调试方式

使用 MCP Inspector 进行调试:

npm run inspector

Inspector 将提供一个 URL,可在浏览器中访问调试工具。

许可证

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