项目简介

mcp-ankiconnect 是一个 MCP (Model Context Protocol) 服务器，旨在将大型语言模型（如 Claude）与 Anki 抽认卡应用程序集成。通过这个服务器，你可以使用自然语言指令让 Claude 与你的 Anki 抽认卡进行交互，例如复习待复习的卡片、创建新的抽认卡等，从而实现更便捷、智能的间隔重复学习体验。

主要功能点

获取待复习卡片: 允许 Claude 获取 Anki 中待复习的卡片，并可以按牌组筛选。
提交复习结果: 允许 Claude 将用户对卡片的复习评分提交回 Anki，更新卡片复习进度。
列出牌组和笔记类型: 允许 Claude 获取 Anki 中可用的牌组和笔记类型信息，辅助用户进行卡片管理。
获取示例笔记: 提供从 Anki 获取示例笔记的功能，帮助用户了解如何创建有效的抽认卡。
添加新笔记: 允许 Claude 在 Anki 中创建新的抽认卡，方便用户快速记录和学习新知识。

安装步骤

安装 AnkiConnect 插件:
- 打开 Anki 应用程序。
- 点击 "工具" (Tools) -> "插件" (Add-ons) -> "获取插件..." (Get Add-ons...).
- 输入插件代码 '2055492159' 并点击 "确定" (Ok)。
- 重启 Anki 以完成插件安装。
配置 Claude 桌面应用:
- 找到 Claude 桌面应用的配置文件 'claude_desktop_config.json'。
  - MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
  - Windows: '%APPDATA%/Claude/claude_desktop_config.json'
- 编辑该文件，在 'mcpServers' 字段中添加 'mcp-ankiconnect' 服务器的配置信息。如果 'mcpServers' 字段不存在，请创建它。

服务器配置

在 Claude 桌面应用的配置文件 'claude_desktop_config.json' 中，添加以下配置信息以连接 mcp-ankiconnect 服务器：

{
  "mcpServers": {
    "mcp-ankiconnect": {
      "command": "uv",
      "args": ["run", "--with", "mcp-ankiconnect", "mcp-ankiconnect"]
    }
  }
}

配置参数说明:

'"mcp-ankiconnect"': 服务器名称，可以自定义，用于在 Claude 客户端中标识该服务器。
'"command": "uv"': 启动服务器的命令。这里使用 'uv'，它是一个快速的 Python 包安装和运行工具，需要确保你的环境中已安装 'uv'。如果你的环境中没有 'uv'，可能需要替换为 'python' 或其他可以运行 Python 脚本的命令，并相应调整 'args'。
'"args": ["run", "--with", "mcp-ankiconnect", "mcp-ankiconnect"]': 传递给 'command' 的参数。
- '"run"': 'uv run' 命令用于运行指定的 Python 包或模块。
- '"--with", "mcp-ankiconnect"': 指定运行环境为 'mcp-ankiconnect'，这通常与项目的虚拟环境或 Poetry 环境配置有关。
- '"mcp-ankiconnect"': 指定要运行的模块或入口点，这里指向 'mcp-ankiconnect' 包。

注意: 请确保你的 Python 环境中已安装 'uv' 和 'mcp-ankiconnect' 及其依赖。你可以参考仓库的 README 文件或使用 'uv sync' 命令安装项目依赖。

重启 Anki 和 Claude 桌面应用:
- 重启 Anki 应用程序。
- 重启 Claude 桌面应用程序，使配置生效。

基本使用方法

配置完成后，你可以在 Claude 中使用自然语言指令与 Anki 进行交互。例如：

在 Claude 中提问： "今天有哪些抽认卡需要复习？" 或 "Let's go through today's flashcards"。
Claude 可能会调用 'num_cards_due_today' 或 'fetch_due_cards_for_review' 工具来获取 Anki 中待复习的卡片信息。
在 Claude 的引导下完成卡片复习后，Claude 可能会调用 'submit_reviews' 工具将你的复习结果提交回 Anki。
你还可以指示 Claude 创建新的抽认卡，例如 "为这个内容制作抽认卡" 或 "Make flashcards for this"。

具体的使用方式取决于 Claude 客户端如何利用 MCP 服务器提供的工具。请参考 Claude 客户端的文档或提示，了解如何与 mcp-ankiconnect 服务器进行更深入的交互。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息