TalkToAnki

一个优化的 MCP (Model Context Protocol) 工具，通过 AnkiConnect 与 Anki 无缝集成，为AI助手提供强大的 Anki 操作能力。

- 🔍智能查询: 查询卡片和卡组信息
- ➕内容管理: 创建卡片和卡组
- 📊数据分析: 获取复习统计和学习数据
- 🔄同步支持: 完整的同步操作支持
- 🛡️错误处理: 完善的错误处理和重试机制
- ⚡性能优化: 连接池、并发控制和资源管理
- 📦单文件部署: 所有功能集成在一个文件中，部署简单
- 🚀零配置启动: 无需复杂的模块管理和导入

TalkToAnki/ ├── talktoanki_server.py # ⭐ 完整的单文件服务器（包含所有功能） ├── requirements.txt # 项目依赖 ├── pyproject.toml # 现代Python包配置 ├── README.md # 项目文档 ├── README_EN.md # 英文文档 ├── CONTRIBUTING.md # 贡献指南 ├── CHANGELOG.md # 变更日志 ├── LICENSE # MIT许可证 ├── .gitignore # Git忽略文件 └── examples/ # 配置示例 └── cursor_mcp_config.json

- Python: 3.8+
- Anki: 桌面版（需要安装 AnkiConnect 插件）
- MCP客户端: Cursor 或其他支持MCP的AI客户端

git clone https://github.com/your-username/TalkToAnki.git cd TalkToAnki

- 打开Anki桌面版
- 进入 工具 > 插件 > 获取插件
- 输入插件代码:2055492159
- 重启Anki

将以下配置添加到Cursor的MCP配置文件 (~/.cursor/mcp.json):

{ "mcpServers": { "anki": { "command": "python", "args": ["/path/to/your/project/TalkToAnki/talktoanki_server.py"], "env": { "ANKI_CONNECT_URL": "http://localhost:8765", "ANKI_CONNECT_VERSION": "6", "LOG_LEVEL": "INFO" } } } }

💡提示: 将/path/to/your/project/TalkToAnki/替换为实际的项目路径
- 确保 Anki 桌面版正在运行
- 重启 Cursor
- 开始使用 Anki MCP 工具！

- anki_get_deck_names: 获取所有卡组列表
- anki_create_deck: 创建新卡组
- anki_get_deck_stats: 获取卡组统计信息

- anki_add_note: 添加新卡片
- anki_find_notes: 查询卡片
- anki_get_note_info: 获取卡片详细信息

- anki_sync: 同步Anki数据库
- anki_get_server_info: 获取服务器状态和配置信息

- anki_update_note: 更新现有卡片内容和标签
- anki_delete_notes: 批量删除卡片
- anki_move_notes: 将卡片移动到指定卡组
- anki_suspend_notes: 暂停或恢复卡片学习

- anki_get_due_cards: 获取到期需要复习的卡片信息
- anki_get_study_progress: 获取详细的学习进度统计
- anki_get_review_history: 获取复习历史数据和成功率分析

- anki_batch_add_notes: 批量添加多张卡片
- anki_batch_update_tags: 批量更新卡片标签
- anki_export_deck: 导出指定卡组为.apkg文件

- anki_change_note_type: 更改卡片的笔记类型（模板）
- anki_get_note_types: 获取所有可用的笔记类型列表

{ "action": "create_deck", "deck_name": "我的新卡组", "success": true, "message": "卡组 '我的新卡组' 创建成功" }

{ "action": "find_notes", "query": "deck:我的新卡组", "note_ids": [1234567890], "count": 1, "success": true }

{ "action": "batch_add_notes", "deck_name": "英语单词", "total_attempted": 3, "successful_count": 3, "failed_count": 0, "successful_note_ids": [1234567890, 1234567891, 1234567892], "success": true, "message": "批量添加完成：成功 3 张，失败 0 张" }

{ "action": "get_study_progress", "deck_name": "英语单词", "analysis_period_days": 7, "total_cards": 150, "new_cards": 20, "young_cards": 30, "mature_cards": 100, "recent_reviews": 45, "mature_percentage": 66.67, "new_percentage": 13.33, "success": true }

{ "action": "get_review_history", "deck_name": "英语单词", "period_days": 30, "total_reviews": 120, "again_count": 10, "hard_count": 15, "good_count": 70, "easy_count": 25, "success_rate_percentage": 79.17, "total_studied_cards": 100, "success": true }

{ "action": "change_note_type", "original_note_ids": [1234567890, 1234567891], "new_note_ids": [1234567900, 1234567901], "original_model": "Cloze", "target_model": "挖空模板", "total_processed": 2, "successful_count": 2, "failed_count": 0, "field_mapping_used": "auto", "success": true, "message": "成功将 2 张卡片从 'Cloze' 更改为 '挖空模板'" }

{ "action": "get_note_types", "total_count": 5, "note_types": ["Basic", "Cloze", "挖空模板", "Basic (reversed)", "Image Occlusion"], "detailed_info": [ { "name": "Basic", "fields": ["Front", "Back"] }, { "name": "Cloze", "fields": ["Text", "Extra"] } ], "success": true, "message": "找到 5 个笔记类型" }

- 确保 Anki 桌面版正在运行
- 启动 MCP 服务器
- 在支持 MCP 的客户端中调用任何工具进行验证

- 连接验证：调用anki_get_server_info
- 卡组操作：调用anki_get_deck_names
- 卡片操作：创建测试卡组并添加卡片

- 确保 Anki 桌面版正在运行
- 检查 AnkiConnect 插件是否正确安装
- 验证 MCP 配置文件路径正确

- 确认 AnkiConnect 插件已启动
- 检查防火墙设置
- 验证端口 8765 未被占用

- 检查 Anki 是否有弹窗等待用户操作
- 重启 Anki 和 MCP 客户端
- 查看日志文件排查具体错误

# 克隆仓库 git clone https://github.com/your-username/TalkToAnki.git cd TalkToAnki # 创建虚拟环境 python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate # 安装开发依赖 pip install -e ".[dev]" # 验证安装 python talktoanki_server.py --help

- AnkiConnect- 提供 Anki 集成能力
- FastMCP- 现代化的 MCP 服务器框架
- Anki- 优秀的间隔重复学习软件

Sync Calendars, Scheduling Links, AI Executive Scheduling Assistant, Unified Calendar