FlashCardMCP / 闪卡生成MCP服务

Version: 10.1

项目介绍

FlashCardMCP 是一个基于 FastMCP 的 MCP 服务，用于将 JSON/CSV 格式的 Markdown 内容转换为交互式闪卡页面。这个服务适用于学习、教学和知识管理以及任何你想要的场景，可以帮助用户创建自己的数字闪卡集。

• 专注内容：使用Markdown格式，符合LLM的输出，让用户专注于内容的输出，而不是格式等其他无关紧要的内容；
• 稳定输出：采用函数稳定生成闪卡，支持CSS格式Style输入，满足个性化需求；
• 场景化模板： 预制模板用于预设的不同场景，后续会进一步拓展；
• PDF输出：闪卡可打印成PDF（8连卡），进一步满足不同场景下，以及现实多种场景下的使用和记忆。

功能特性

1. Markdown 支持: 闪卡内容支持完整的 Markdown 语法，包括标题、列表、代码块、表格等
2. 交互式闪卡: 点击卡片可以翻转查看背面内容
3. 多种模板: 提供 Default、Minimal、Listen 三种不同的闪卡模板
4. 语音功能: Listen 模板支持语音播放和听写模式（考虑到兼容性，目前仅是Web Speech API，效果一般）
5. 响应式设计: 适配不同屏幕尺寸
6. 打印支持: 支持导出 PDF 和打印功能
7. 数据验证: 内置数据格式验证功能
8. CSV 转换: 支持从 CSV 数据快速创建闪卡

HTML 闪卡示例

• card_template_sample.html: Default 模板的完整示例，展示流式网格布局和翻转动画效果
• minimal_template_sample.html: Minimal 模板示例，单卡片居中显示，适合专注学习
• listen_template_sample.html: Listen 模板示例，支持语音播放和听写模式

PDF 输出示例

sample/pdf_generate/ 目录包含多种场景的PDF闪卡示例：

• 康奈尔笔记法闪卡_8卡片布局.pdf: 学习方法类闪卡
• 基础测试_8卡片布局.pdf: 基础知识测试闪卡
• Markdown测试_8卡片布局.pdf: Markdown语法支持演示
• 词语表闪卡练习_8卡片布局.pdf: 词汇学习闪卡
• 日文注音测试_8卡片布局.pdf: 多语言支持示例

所有PDF采用A4纸8卡片布局，适合打印和实体使用。

版本记录

Version 10.1 (当前版本)

• 更新了所有README文件中的版本信息
• 修正了MCP工具和资源的描述，确保与实际功能一致
• 更新了MCP客户端配置，使用正确的uv run命令
• 完善了文档结构和内容

未来版本计划

• 增加更多闪卡模板
• 优化语音功能
• 添加在线Demo页面
• 支持更多导出格式

许可证

本项目采用 GPL 协议。