AI导哈

Anki卡片管理服务

一个通过AnkiConnect为Claude Desktop提供Anki闪卡创建、搜索、编辑和删除功能的本地MCP服务器。

  • by james-rosen
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 james-rosen/anki-mcp

使用说明

安基mcp

一 MCP服务器 这使Claude Desktop可以通过以下方式访问您的Anki闪卡 AnkiConnect。创建、搜索、编辑和删除卡片。在当地运行。

例子

  • “为我的历史牌制作10张关于法国大革命的抽认卡”
  • “查找我所有标记为‘西班牙语’并提到不规则动词的卡片”
  • “第三张牌是错的，答案应该是‘fue’而不是‘era’”
  • “把那张卡片分成三张单独的卡片，每个动词时态一张”
  • “同步我的收藏”

设置

您需要Anki与AnkiConnect、此仓库以及Claude Desktop中的一次性配置更改。

步骤1：在Anki中安装AnkiConnect

  1. 打开 Anki
  2. 首选 工具>附加组件>获取附加组件。..
  3. 粘贴此代码： 2055492159
  4. 点击 好的 和 重新启动Anki

AnkiConnect 公开此服务器与之对话的本地API。若要验证它是否正在运行，请打开http://localhost:8765在浏览器中，您应该看到 AnkiConnect v.6.

步骤2：克隆此仓库

你需要 紫外线。如果您没有：

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# or with Homebrew
brew install uv

然后克隆这个仓库：

git clone https://github.com/james-rosen/anki-mcp.git

uv 首次运行时自动处理依赖关系。

步骤3：配置Claude桌面

打开您的Claude Desktop配置文件：

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json

添加 anki 到 mcpServers 部分（与任何现有服务器合并）：

{
  "mcpServers": {
    "anki": {
      "command": "uv",
      "args": [
        "--directory", "/absolute/path/to/anki-mcp",
        "run", "anki_mcp.py"
      ]
    }
  }
}

重要：替换 /absolute/path/to/anki-mcp 带有克隆仓库的完整路径。例如：

  • macOS： /Users/yourname/projects/anki-mcp
  • 窗户： C:\\Users\\yourname\\projects\\anki-mcp

小贴士：如果克劳德桌面找不到 uv，使用完整路径，而不是仅使用 "command": "uv".快跑 which uv 在您的终端中找到它（例如。 /Users/yourname/.local/bin/uv).

步骤4：重新启动并验证

  1. 确保Anki打开 --这些工具只有在Anki运行时才能工作
  2. 完全退出克劳德桌面 （macOS上的Cmd+Q，而不仅仅是关闭窗口）并重新打开它
  3. 开始a 新对话
  4. 点击 连接器 输入区域附近的菜单并确认 安记 已打开
  5. 问克劳德 “我在安基有什么甲板？” --如果它列出了你的牌组，你就准备好了

工具

工具 它做什么
list_decks 列出您的所有牌组名称
list_models 列出您的笔记类型（基本、完形等）
get_model_fields 显示注释类型的字段（例如，“基本”为“前/后”）
create_deck 创建新甲板——使用 :: 用于下层甲板（例如。 Languages::Spanish)
add_note 使用您指定的卡片组、笔记类型、字段和标签创建抽认卡
search_notes 使用搜索您的收藏 Anki的搜索语法 并返回完整的卡详细信息
update_note 编辑卡片内容或标签
update_note_tags 替换卡上的所有标签
delete_notes 按ID删除一张或多张卡
sync 触发与AnkiWeb的同步

搜索语法

search_notes 用途 Anki的搜索语法。你可以用简单的英语问克劳德，他会翻译，或者直接使用语法：

查询 它发现了什么
deck:Spanish 西班牙语版中的所有笔记
deck:Languages::Spanish 下层甲板上的注释
tag:verb 标记为“动词”的注释
"irregular verb" 包含确切短语的注释
front:bonjour 注意前字段包含“bonjour”的地方
added:7 最近7天添加的注释
rated:1 今日审阅的笔记
is:due 当前到期的笔记
tag:verb deck:Spanish 组合多个过滤器

完整参考： Anki搜索文档

运作原理

You
 ↕  chat
Claude Desktop
 ↕  stdio (JSON messages)
anki_mcp.py (this server)
 ↕  HTTP to localhost:8765
Anki desktop app (via AnkiConnect add-on)

一切都在本地运行。唯一的网络调用是在这个脚本和本地主机上的Anki之间。没有数据离开你的机器（除非你触发与AnkiWeb的同步）。

许可证

麻省理工学院

相关 MCP