Anki MCP Server 使用说明

项目简介

Anki MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在桥接大型语言模型 (LLM) 和流行的记忆卡片软件 Anki。通过此服务器，LLM 能够访问您的 Anki 卡片库，并利用工具来管理和操作卡片，从而实现更智能的学习和知识管理应用。

主要依赖：

Anki 桌面应用: 您需要安装并运行 Anki 桌面应用程序。
Anki-Connect 插件: Anki MCP Server 依赖 Anki-Connect 插件与 Anki 应用通信，请确保已安装并启用该插件。

主要功能点

资源访问 (Resources):
- 查看当前牌组卡片 (anki://search/deckcurrent): 获取当前所选牌组中的所有卡片。
- 查看待复习卡片 (anki://search/isdue): 获取所有待复习和学习中的卡片。
- 查看新卡片 (anki://search/isnew): 获取所有尚未学习过的新卡片。
工具调用 (Tools):
- 更新卡片复习结果 (update_cards): 标记卡片已回答，并更新卡片的艾宾浩斯遗忘曲线参数。
- 添加新卡片 (add_card): 在默认牌组中创建新的卡片。
- 获取待复习卡片 (get_due_cards): 获取指定数量的待复习卡片。
- 获取新卡片 (get_new_cards): 获取指定数量的新卡片。

安装步骤

安装 Node.js 和 npm: 确保您的系统已安装 Node.js 和 npm (Node 包管理器)。
下载仓库代码: 从 GitHub 仓库 https://github.com/scorzeth/anki-mcp-server 下载代码到本地。
安装依赖: 打开终端或命令提示符，进入仓库代码根目录，运行以下命令安装项目依赖：
```
npm install
```
构建服务器: 运行以下命令构建服务器：
```
npm run build
```
构建成功后，会在 'build' 目录下生成 'index.js' 文件，这是服务器的入口文件。

服务器配置

MCP 服务器需要配置在 MCP 客户端中才能使用。以 Claude Desktop 为例，您需要在 Claude Desktop 的配置文件中添加 Anki MCP Server 的配置信息。

配置文件路径：

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

配置信息 (JSON 格式):

{
  "mcpServers": {
    "anki-mcp-server": {  // 服务器名称，可以自定义
      "command": "/path/to/anki-mcp-server/build/index.js" //  Anki MCP Server 启动命令，请将 "/path/to/anki-mcp-server" 替换为您的 Anki MCP Server 代码在本地的实际路径
    }
  }
}

配置说明:

'"anki-mcp-server"': 服务器名称，您可以自定义，用于在 MCP 客户端中标识该服务器。
'"command"': 服务器启动命令。
- 请将 '"/path/to/anki-mcp-server/build/index.js"' 替换为 Anki MCP Server 构建后 'index.js' 文件的绝对路径。例如，如果您的 'anki-mcp-server' 仓库代码放在用户目录下的 'projects' 文件夹中，则路径可能类似于 '/Users/your_username/projects/anki-mcp-server/build/index.js' (MacOS) 或 'C:\Users\your_username\AppData\Roaming\projects\anki-mcp-server\build\index.js' (Windows)。
- 注意： 这里只需要指定 'index.js' 文件的路径，不需要额外的参数。

基本使用方法

启动 Anki 桌面应用并确保 Anki-Connect 插件已启用。
配置 MCP 客户端 (如 Claude Desktop) 并添加 Anki MCP Server 的配置信息。
在 MCP 客户端中连接到 Anki MCP Server。 连接成功后，LLM 客户端就可以：
- 列出和读取 Anki 卡片资源: LLM 可以请求服务器列出可用的 Anki 卡片资源，并根据资源 URI 读取卡片数据，例如获取待复习的卡片列表。
- 调用 Anki 工具: LLM 可以调用服务器提供的工具来操作 Anki，例如让 LLM 根据用户反馈更新卡片复习结果，或创建新的卡片。

例如，在与 Claude Desktop 等 LLM 应用对话时，您可以指示 LLM：

"帮我查看一下今天有哪些 Anki 卡片需要复习？" (LLM 可能会使用 'anki://search/isdue' 资源获取待复习卡片)
"我刚刚复习了这张卡片，感觉掌握程度一般。" (LLM 可能会使用 'update_cards' 工具更新卡片复习结果)
"帮我添加一张关于光合作用的新卡片，正面是 '光合作用的公式是什么？'，背面是 '6CO2 + 6H2O + 光照 → C6H12O6 + 6O2'" (LLM 可能会使用 'add_card' 工具添加新卡片)

通过 Anki MCP Server，LLM 能够理解和操作您的 Anki 卡片数据，从而实现更智能、更个性化的学习辅助功能。

关键词