anki-mcp-server

anki-mcp-server

site icon
2025.04.17 2
Python闪卡创建知识管理语言学习开发效率
anki-mcp-server是一个模型上下文协议(MCP)服务器,作为Claude和Anki之间的桥梁,允许用户通过自然语言命令轻松创建和管理Anki闪卡。该服务支持多种闪卡类型和牌组管理功能,适用于语言学习、知识整理等场景。
View on GitHub

Overview

基本能力

产品定位

anki-mcp-server是一个连接Claude和Anki的MCP服务器,旨在通过自然语言交互简化闪卡创建和管理流程。

核心功能

  1. 闪卡创建功能
  2. 基础问答格式闪卡创建
  3. 语言学习闪卡创建(单词、释义、例句)
  4. 自动添加标签
  5. 支持多牌组添加

  6. 牌组管理功能

  7. 查看可用牌组列表
  8. 创建新牌组
  9. 搜索特定牌组中的卡片

适用场景

  • 语言学习(如日语、英语词汇记忆)
  • 知识整理(如编程概念总结)
  • 历史时间线记忆
  • 各类学习内容的闪卡化

工具列表

  • AnkiConnect:Anki插件,提供API接口
  • Claude Desktop:支持MCP协议的Claude客户端

常见问题解答

  1. 连接问题
  2. 确保Anki正在运行
  3. 验证AnkiConnect是否安装正确(访问http://localhost:8765)
  4. Windows用户可能需要配置防火墙

  5. MCP服务器问题

  6. 检查服务器日志
  7. 尝试重启Anki、Claude Desktop和MCP服务器

使用教程

使用依赖

  • Python 3.8或更高版本
  • Anki 2.1.x或更高版本
  • AnkiConnect插件
  • Claude Desktop(或可访问Claude API的环境)

安装教程

  1. 设置Anki和AnkiConnect bash # 安装AnkiConnect插件 # 在Anki中选择Tools > Add-ons > Get Add-ons # 输入代码2055492159 # 重启Anki

  2. 安装anki-mcp-server bash git clone https://github.com/dhkim0124/anki-mcp-server.git cd anki-mcp-server python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate pip install -r requirements.txt

  3. 配置Claude Desktop

  4. 修改配置文件添加MCP服务器信息 json { "mcpServers": { "anki-mcp": { "command": "python", "args": ["path/anki_server.py"], "env": {} } } }

调试方式

  1. 运行Anki并保持后台运行
  2. 启动Claude Desktop
  3. 使用自然语言命令测试功能,例如:
  4. "Add an easy Japanese vocabulary card to my Japanese deck"
  5. "Create a card for the English word 'perseverance'"
  6. 检查Anki中是否成功创建对应卡片

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。