金大哥 - Anki MCP 详情

article

README

🚀 Anki-MCP 服务器

Anki-MCP 服务器是一个与 Anki 集成的 MCP 服务器，借助 AnkiConnect 插件实现。它基于 TypeScript 构建，展示了核心 MCP 概念，能通过资源表示 Anki 卡组和笔记模型，还提供创建与管理 Anki 笔记的工具，并集成了 AnkiConnect API。

✨ 主要特性

资源

可通过 anki://decks/{id} URI 列出并访问所有 Anki 卡组。
能通过 anki://models/{id} URI 列出并访问所有笔记模型。
提供 Anki 对象的 JSON 表示。

工具

listDecks：获取所有卡组的名称。
listModels：获取所有笔记模型的名称。
getModel：获取特定笔记模型的详细信息。
addNote：创建一条笔记，需指定卡组名称、模型名称、字段和标签。
addNotes：批量创建多条笔记，使用指定参数创建。

📦 安装指南

开发依赖安装

npm install

服务器构建

npm run build

带有自动重建的开发模式

npm run watch

在 Claude Desktop 上使用的安装步骤

要在 Claude Desktop 上使用，请添加服务器配置：

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "anki-mcp": {
      "command": "node",
      "args": ["d:\\anki-mcp-server\\build\\index.js"]
    }
  }
}

💻 使用示例

基础用法

在开发过程中，若要安装依赖，可使用以下命令：

npm install

高级用法

若要在开发时实现自动重建功能，可使用以下命令：

npm run watch

🔧 技术细节

本项目是一个基于 TypeScript 的 MCP 服务器，通过集成 AnkiConnect API 实现与 Anki 的交互。在资源方面，利用 URI 来表示 Anki 卡组和笔记模型，方便对其进行访问和管理。在工具方面，提供了一系列函数来实现对 Anki 笔记的创建和管理操作。开发过程中，使用 npm 进行依赖管理和项目构建，通过 npm run build 命令将 TypeScript 代码编译为 JavaScript 代码，使用 npm run watch 命令可在开发时实现自动重建，提高开发效率。在安装方面，需要在 Claude Desktop 的配置文件中添加服务器配置，以确保服务器能正常运行。

📄 许可证

原文档未提及许可证信息，故此处不展示相关内容。

Anki