← 返回目录
A

Anki MCP Server

社区
用 AI 对话管理 Anki 学习。
分类
其他 第 57 / 230
Stars
★ 519 非常热门
传输方式
stdio(本地进程)
运行环境
Node.js 22.12.0+
凭据
无需凭据
许可证
MIT
最近提交
工具数
48
62FMRS · C

基于提供的仓库、清单和 README:这是一个独立的 Anki MCP 集成,使用 MIT 许可证,通过 AnkiConnect 提供 42 个 MCP 工具。清单版本为 0.18.4,README 的当前状态部分写为 0.22.0,版本信息存在不一致。

最强项 · 文档质量 15/20 最弱项 · 可靠性 9/20

可靠性
9/20
安全与权限
14/20
维护活跃度
11/20
文档质量
15/20
安装易用性
13/20
查看各项评分依据
可靠性 9/20
静态材料显示存在清晰的 STDIO/HTTP/Tunnel 入口、依赖和错误防护说明,MCP 初始化及工具列表流程在概念上可行。但未提供实际源代码、CI 工作流或已提交测试,无法验证启动、握手、42 个工具与实现的一致性;manifest 为 0.18.4,而 README 后段称当前为 0.22.0,属于可审计的版本矛盾。因此按静态校准不超过 12,并因关键路径不可验证而扣分。
安全与权限 14/20
材料披露了本地默认绑定、Host/Origin 校验、媒体路径与 URL 的 SSRF/路径遍历防护、隧道 OAuth、0600 凭据权限及若干破坏性操作的显式确认,且说明数据默认留在本机。扣分原因是 HTTP 当前无认证,ngrok 模式明确未认证并可暴露 Anki,工具整体拥有广泛写权限;read-only 说明又允许 sync、answerCards、suspend/unsuspend,权限边界并非完全只读。未见源代码或安全测试证据,不能给满分。
维护活跃度 11/20
项目未归档,README 显示 MIT 许可、beta 状态、GitHub Actions 测试徽章、npm 发布路径、漏洞报告链接和支持邮箱,说明存在维护与反馈渠道。扣分原因是仅凭给定材料无法核实提交频率、发布持续性、依赖更新或 issue 响应;README 的 0.22.0 与 manifest/npm 包 0.18.4 不一致,版本治理也存在缺口。
文档质量 15/20
README 覆盖安装、客户端配置、三种传输、环境变量、工具清单、示例、权限/安全边界、已知限制、故障排查、开发和测试命令,信息层次较完整。扣分原因是工具参数的完整 schema、真实测试结果、运行时行为和成本信息未提供;README 内部存在版本矛盾,且部分外部文档只能被链接引用,无法在本次材料中复核。
安装易用性 13/20
提供 npm/npx、全局安装、源码和 MCPB 多种路径,并包含 Claude Desktop 配置、STDIO/HTTP/Tunnel 示例及 Node.js 与 AnkiConnect 前置条件,主流本地客户端的连接步骤较清楚。扣分原因是必须先安装并配置 Anki 与 AnkiConnect,远程模式涉及 OAuth、隧道或不安全的 ngrok 选项;没有实际安装或端到端连接证据,且版本不一致使可复现性下降。按静态校准不超过 15。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络连接数据库

适合谁

  • 已使用 Anki 和 AnkiConnect 的个人学习者。
  • 需要 AI 辅导式复习、解释和动态创建卡片的用户。
  • 需要通过 Claude Desktop、Cursor、Cline 或 Zed 使用本地 Anki 的用户。

不适合谁

  • 不使用 Anki 桌面应用或 AnkiConnect 的用户。
  • 需要官方 Anki 支持或官方集成的组织。
  • 只需要纯复习流程的远程用户;GUI 工具面向编辑和创建,不面向复习会话。

所需权限

  • 需要连接配置的 AnkiConnect URL,默认访问本机 http://localhost:8765。
  • 写入操作可创建、修改、移动和删除 Anki 内容;删除工具要求明确确认。
  • 媒体导入可读取指定文件路径或 URL,具体范围受媒体安全配置限制。
  • 启用 AnkiWeb 同步时,Anki 应用会直接与 AnkiWeb 同步。

风险与副作用

  • 项目明确处于 Beta 阶段,API 和功能可能变化。
  • 删除笔记会永久删除其关联卡片;清理未使用标签、删除媒体和字段删除也可能造成数据损失。
  • updateNoteFields 在 Anki 浏览器正在查看该笔记时可能静默失败。
  • ngrok 模式未认证,任何获得 URL 的人都可能访问 Anki;托管 Tunnel 需要登录认证。
  • 远程暴露 HTTP 服务需要正确配置 ALLOWED_HOSTS;错误配置会导致拒绝请求或扩大暴露范围。

安装接入

准备工作

运行环境:Node.js 22.12.0+

ANKI_CONNECT_API_KEY 可选密钥 如果在 AnkiConnect 中配置了 API key 才需要设置。
TUNNEL_AUTH_CLIENT_ID 可选密钥 OAuth 设备流程的客户端 ID,仅自托管隧道时需要。
其他可选配置项(13 个)
ANKI_CONNECT_URL 可选 AnkiConnect 插件的 URL,默认 http://localhost:8765,一般无需修改。
ANKI_CONNECT_API_VERSION 可选 AnkiConnect API 版本,默认 6。
ANKI_CONNECT_TIMEOUT 可选 请求超时毫秒数,默认 5000。
READ_ONLY 可选 设为 true 或 1 可启用只读模式,阻止所有写操作。
ALLOWED_HOSTS 可选 HTTP 模式下除回环地址外额外允许的 Host 头,绑定局域网/公网地址时必须设置。
ALLOWED_ORIGINS 可选 HTTP 模式下允许的浏览器 Origin/Referer 模式列表,支持通配符。
TUNNEL_SERVER_URL 可选 隧道模式的 WebSocket 服务地址,默认 wss://tunnel.ankimcp.ai。
MEDIA_ALLOWED_TYPES 可选 额外允许的 MIME 类型(逗号分隔),如 application/pdf。
MEDIA_IMPORT_DIR 可选 限制文件路径导入只能来自该目录。
MEDIA_ALLOWED_HOSTS 可选 允许 URL 导入访问的私有网络主机列表。
PORT 可选 HTTP 模式监听端口,默认 3000。
HOST 可选 HTTP 模式绑定地址,默认 127.0.0.1。
LOG_LEVEL 可选 日志级别,默认 info。

先安装 Anki 和 AnkiConnect,并确认 AnkiConnect 使用 http://localhost:8765。安装 Node.js 22.12.0 或更高版本。使用 npx 运行服务器,并将上方配置加入支持 STDIO 的 MCP 客户端;Claude Desktop 也可安装项目发布的 MCPB bundle。

claude_desktop_config.json
{"mcpServers":{"anki-mcp":{"command":"npx","args":["-y","@ankimcp/anki-mcp-server","--stdio"],"env":{"ANKI_CONNECT_URL":"http://localhost:8765"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同(如 VS Code 使用 servers 字段),可用下方配置生成器转换。

.vscode/mcp.json
{
  "servers": {
    "anki-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ankimcp/anki-mcp-server",
        "--stdio"
      ],
      "env": {
        "ANKI_CONNECT_URL": "http://localhost:8765"
      }
    }
  }
}

写入项目的 .vscode/mcp.json(VS Code 使用 servers 字段)。

Terminal
claude mcp add anki-mcp -e ANKI_CONNECT_URL=http://localhost:8765 -- npx -y @ankimcp/anki-mcp-server --stdio

在终端运行;先把 <…> 占位符换成你自己的值。

验证是否装好

在 Claude Desktop 或其他 MCP 客户端的工具列表中应出现 sync、listDecks、get_due_cards 等工具;也可以输入“列出我的所有牌组”,若返回真实牌组数据则说明与 AnkiConnect 的连接正常。

常见排障

  1. 确认 Anki 正在运行且 AnkiConnect 已安装。
  2. 检查 ANKI_CONNECT_URL、API 版本、API 密钥和 5000 毫秒默认超时设置。
  3. 确认 Node.js 版本至少为 22.12.0。
  4. STDIO 客户端应使用 --stdio;HTTP 模式默认监听 127.0.0.1:3000。
  5. 更新笔记前关闭 Anki 浏览器中的该笔记,或切换到其他笔记。
  6. 远程或非回环访问时检查 ALLOWED_HOSTS、ALLOWED_ORIGINS 及隧道配置。

试试这样问

连接成功后,可以直接对 AI 助手这样说:

  • 帮我复习我的西班牙语牌组。
  • 创建10张阿拉伯语词汇卡片,使用从右到左的样式。
  • 把我下载文件夹里的这张图片导入到当前选中笔记的正面。
  • 列出所有牌组及其卡片数量统计。

工具能力 48

sync 写入
与 AnkiWeb 同步数据。
get_due_cards 只读
获取待复习卡片,可按牌组筛选。
get_cards 只读
按状态和牌组灵活筛选卡片。
present_card 只读
展示卡片的问题或正面。
rate_card 写入
记录复习评价并安排下一次复习。
listDecks 只读
列出牌组,可附带卡片统计。
deckStats 只读
获取单个牌组的综合统计。
createDeck 写入
创建空牌组,支持最多两级层级。
展开其余 40 个工具
changeDeck 写入
移动卡片到其他牌组,目标不存在时创建。
addNote 写入
创建单条笔记及其字段和标签。
addNotes 写入
批量创建最多100条共享牌组和模型的笔记。
findNotes 只读
使用 Anki 查询语法搜索笔记。
notesInfo 只读
获取笔记字段、标签和样式等详细信息。
updateNoteFields 写入
更新笔记字段,支持 HTML 并保留样式。
deleteNotes 破坏性
删除笔记及其关联卡片,需要确认。
getTags 只读
获取集合中的所有标签。
addTags 写入
为指定笔记添加标签。
removeTags 写入
从指定笔记移除标签。
replaceTags 写入
在指定笔记中重命名标签。
clearUnusedTags 破坏性
删除未被笔记使用的孤立标签。
getMediaFilesNames 只读
列出媒体目录中的文件名,可按模式筛选。
retrieveMediaFile 只读
以 Base64 内容读取媒体文件。
storeMediaFile 写入
从 Base64、绝对路径或 URL 上传媒体。
deleteMediaFile 破坏性
删除媒体目录中的媒体文件。
modelNames 只读
列出可用笔记类型。
modelFieldNames 只读
获取指定笔记类型的字段名。
modelStyling 只读
获取笔记类型的 CSS 样式。
modelTemplates 只读
获取笔记类型的卡片模板。
createModel 写入
创建带自定义字段、模板和 CSS 的笔记类型。
updateModelStyling 写入
更新笔记类型 CSS,并应用到其所有卡片。
updateModelTemplates 写入
更新卡片模板,并应用到其所有卡片。
addModelField 写入
向笔记类型添加字段。
removeModelField 破坏性
删除笔记类型字段,需要明确确认。
renameModelField 写入
重命名笔记类型字段。
repositionModelField 写入
调整字段在笔记类型中的位置。
collection_stats 只读
获取所有牌组的汇总统计和分牌组明细。
review_stats 只读
分析复习历史、保留率和学习连续记录。
guiBrowse 只读
打开卡片浏览器并搜索卡片。
guiSelectCard 只读
在卡片浏览器中选择卡片。
guiSelectedNotes 只读
获取当前选中的笔记 ID。
guiAddCards 写入
打开添加卡片窗口并填入预设笔记信息。
guiEditNote 写入
打开指定笔记的编辑器。
guiDeckOverview 只读
打开指定牌组的概览窗口。
guiDeckBrowser 只读
打开牌组浏览器窗口。
guiCurrentCard 只读
获取复习模式当前卡片信息。
guiShowQuestion 只读
显示当前卡片的问题面。
guiShowAnswer 只读
显示当前卡片的答案面。
guiUndo 写入
撤销 Anki 中的上一个操作。

使用场景

用自然语言复习指定牌组并记录 Again、Hard、Good 或 Easy 评价。
批量创建带自定义字段、卡片模板和 RTL 样式的词汇卡。
搜索、编辑笔记并管理标签和媒体文件。
查看牌组、集合和复习历史统计。

支持客户端

Claude Desktop
Cursor
Cline
Zed

依据项目文档列出,未经本站实测。

详细介绍

Anki MCP Server 通过 AnkiConnect 将 Anki 闪卡、牌组、笔记、媒体和复习流程连接到 AI 助手。服务器支持复习、内容管理、模型与模板管理、统计分析及部分 Anki 桌面界面操作。项目处于 Beta 活跃开发阶段,API 和功能可能变化。

同类可选方案

BioMCP 75 · B

统一的命令行语法,接入约30个可信生物医学数据源。

★ 659 · 工具数 11 与当前对比 →

源版本 e0e347f7f399 数据同步于 2026-10-19 查看 FMRS 评分方法