anki-mcp MCP Server

anki-mcp MCP Server

一个通过AnkiConnect连接到Anki的模型上下文协议服务器。

概述

Anki-MCP 是一个基于 TypeScript 的服务器,通过 AnkiConnect 插件与 Anki 集成,提供卡组管理和笔记创建功能。

前提条件

安装与配置

  1. 安装依赖

    npm install
    
  2. 构建服务器

    npm run build
    
  3. 配置 Claude Desktop

    创建或修改配置文件:

    • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%/Claude/claude_desktop_config.json

    添加以下配置:

    {
      "mcpServers": {
        "anki-mcp": {
          "command": "node",
          "args": ["路径到/anki-mcp-server/build/index.js"]
        }
      }
    }
    

核心功能

资源访问

  • 卡组: anki://decks/{id}
  • 笔记模型: anki://models/{id}

主要工具

工具功能
listDecks获取所有卡组名称
listModels获取所有笔记模型名称
getModel获取特定模型详情
addNote创建单个笔记
addNotes批量创建笔记

开发与调试

  • 开发模式npm run watch
  • 调试:使用 MCP Inspector
    npm run inspector
    
    在浏览器中打开提供的 URL 进行调试

使用示例

使用 Claude 创建 Anki 卡片时,可以指定卡组、模型、字段和标签:

创建一张关于光合作用的 Anki 卡片,放在"生物学"卡组中