MCP 闪卡

用于管理闪卡的MCP服务器 - 可以通过编程方式创建、学习和组织闪卡组。

功能

• 创建和管理闪卡组
• 添加、编辑和删除卡片
• 带有间隔重复的学习模式
• 导入/导出卡片组
• 统计跟踪
• 完整的MCP集成
• 新功能：Claude Desktop的UI工作流集成
• 新功能：人工介入的UI提示
• 新功能：工作流会话管理

安装

bash
npm install @no-smoke/mcp-flashcards

配置

将以下内容添加到您的MCP设置中：

json
{
"mcpServers": {
"flashcards": {
"command": "npx",
"args": ["@no-smoke/mcp-flashcards"],
"env": {
"FLASHCARDS_DATA_DIR": "./flashcards-data"
}
}
}
}

使用方法

创建一个卡片组

typescript
await createDeck({
name: "JavaScript 基础",
description: "基本的JavaScript概念"
});

添加卡片

typescript
await addCard({
deckId: "deck-id",
question: "什么是闭包？",
answer: "一个可以访问其外部作用域变量的函数"
});

学习模式

typescript
const card = await getNextCard({ deckId: "deck-id" });
await markCard({ cardId: card.id, correct: true });

UI 工作流集成 (v1.1.0)

Flashcards MCP服务器现在包括了UI工作流能力，可以直接在Claude Desktop内实现人工介入交互。

主要功能

1. 启动工作流会话：初始化一个用于闪卡操作的UI工作流会话
2. 人工介入提示：获取用户输入来创建卡片组、添加卡片以及进行学习会话
3. 更新会话状态：管理工作流状态和进度
4. 获取会话状态：检查当前工作流的状态和进度

使用UI工作流

启动一个工作流会话

typescript
await startFlashcardSession({
type: "create_deck", // 或者 "study", "import"
metadata: {
deckName: "高级JavaScript概念"
}
});

显示UI提示

typescript
await showFlashcardPrompt({
sessionId: "session-id",
promptType: "card_content",
data: {
currentStep: 1,
totalSteps: 5,
deckName: "高级JavaScript概念"
}
});

更新会话

typescript
await updateFlashcardSession({
sessionId: "session-id",
updates: {
step: 2,
cardsAdded: 1
}
});

工作流类型

• create_deck：交互式卡片组创建工作流
• study：带有UI提示的引导学习会话
• import：带有用户确认的文件导入工作流

UI 组件

工作流系统使用MCP的ui_textarea和ui_select元素来：

• 从用户处收集卡片内容
• 获取用户对学习会话结果的决策
• 确认导入操作
• 在多步骤工作流中显示进度

文档

• 📚 UI 工作流文档 - UI工作流完整指南
• 🔧 UI 工具参考 - UI工具快速参考
• 🔄 迁移指南 - 从v1.0.0升级到v1.1.0
• 📦 发行说明 - 版本历史和变更日志
• 📋 变更日志 - 详细的变更历史

开发

bash

克隆仓库

git clone https://github.com/No-Smoke/mcp-flashcards.git
cd mcp-flashcards

安装依赖

npm install

构建

npm run build

运行测试

npm test

启动开发服务器

npm run dev

许可证

MIT许可证 - 详情请参阅LICENSE文件。