AnkiConnect MCP

一个基于AnkiConnect的快速MCP服务器,用于创建和管理Anki闪卡,内置基于间隔重复研究的质量验证功能。

  • by beckspark
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 beckspark/anki-connect-mcp

使用说明

Anki Connect MCP

FastMCP服务器,用于通过AnkiConnect创建和管理Anki闪卡,内置基于间隔重复研究的质量验证。

特性

  • 智能卡创建:创建基本、完形填空和键入抽认卡
  • 质量验证:实施最佳实践(最小信息原则、最佳答案长度等)
  • 历史跟踪:DuckDB数据库跟踪哪些来源生成了哪些卡
  • 多种卡类型:
    • 基础(正面/背面)
    • 堵塞删除(填写空白)
    • 键入答案(需要精确键入)
  • 验证模式:严格、适度或宽松的质量执法
  • 发电模式:自动或混合(创建前预览)

先决条件

  1. Anki 必须正在运行
  2. AnkiConnect 插件必须安装在Anki中
    • 从Anki安装:工具→ 附加组件→ 获取附加组件→ Code: 2055492159
    • 或者安装Anki Connect Plus:https://github.com/Soki-Team/Anki-Connect-Plus

安装

# Clone or navigate to this directory
cd /home/sbeck/code/mcps/anki-connect-mcp

# Install dependencies
uv sync

# Copy environment template
cp .env.example .env

# Edit .env if needed (optional - defaults work for standard setup)

开发状态

已实施:

  • ✅ 基本卡片创建(基本、完形填空、键入)
  • ✅ 质量验证(6条规则)
  • ✅ HTML格式支持(直接和辅助函数)
  • ✅ HTML感知验证(计数长度时去掉标签)
  • ✅ 历史跟踪(DuckDB)
  • ✅ 单例模式(AnkiConnect客户端、数据库)
  • ✅ CallToolResult错误处理(2026最佳实践)
  • ✅ 甲板管理工具(list_decks, create_deck, get_deck_stats)
  • ✅ 用于历史查询的MCP资源(只读数据访问)

计划:

  • ⏳ PDF/epub/web文本提取
  • 反射/反射多“代理”图过程,用于分析和迭代卡片和套牌。

发展

# Run tests
uv run pytest

# Lint
uv run ruff check .

# Format
uv run ruff format .

# Type check
uv run basedpyright

# Install pre-commit hooks
uv run pre-commit install

致谢

内置:

  • 快速MCP -MCP服务器框架
  • AnkiConnect -API安基
  • 间隔重复最佳实践研究(SuperMemo、FSRS算法)