Turn your Claude conversations into learning opportunities.
______________________________________________________________________
当你通过Claude或Claude code探索新概念、调试代码或学习框架时，你实际上保留了多少？Quizz MCP通过生成测试你理解能力的测验，帮助你更深入地参与人工智能互动，为你提供新的视角，揭示你不知道的差距。
为什么？
阅读解释就像理解。但真正的理解来自于积极地回忆和应用概念。Quizz创造了积极的参与度：
- 自我测试 关于你刚才复习的代码
- 发现盲点 根据你的理解
- 获取AI反馈 论你的推理，而不仅仅是对/错
- 跟踪进度 随着时间的推移，跨主题
入门指南
1.安装
git clone https://github.com/ThoBustos/quizz-mcp.git
cd quizz-mcp
pnpm install && pnpm build需要：Node.js 20.11+，pnpm 8+
2.配置克劳德代码
添加到MCP设置(~/.claude/settings.json 或项目 .mcp.json):
{
"mcpServers": {
"quizz": {
"command": "node",
"args": ["/absolute/path/to/quizz-mcp/packages/mcp/dist/index.js"],
"env": {
"ANTHROPIC_API_KEY": "sk-ant-..."
}
}
}
}3.启动Web UI
cd quizz-mcp
pnpm dev开放时间： http://localhost:9004
4.生成您的第一个测验
在Claude Code中，只需问：
Quiz me on what we just discussed或者具体来说：
Generate a quiz about React hooks - 5 questions, medium difficulty, mix of multiple choice and code writing克劳德将要求您确认：
- 内容：要测验什么
- 难度：简单、中等、困难或专家
- 问题计数：1-20个问题
- 问题类型：多选、多选、开放式或代码编写
然后，它会在您的浏览器中打开测验。
参加测验
键盘导航
| 关键 | 行动 |
|---|---|
A-D | 跳转到选项 |
↑/↓ | 导航选项 |
Space | 切换选择（多选） |
Enter | 提交答案 |
Cmd+Enter | 提交代码答案 |
Cmd+Shift+E | 展开/折叠AI聊天 |
AI 聊天
每次回答后，你都可以和克劳德谈谈这个问题。要求澄清，探索边缘案例，或更深入地研究概念。单击展开按钮（或 Cmd+Shift+E)获得全屏聊天体验。
聊天支持代码块、markdown、LaTeX数学等：
难度等级
| 级别 | 通过阈值 | 测试内容 |
|---|---|---|
| 简单 | 50% | 基本回忆，主要观点 |
| 中等 | 60% | 理解、模式、“如何”和“为什么” |
| 硬 | 75% | 分析、联系、权衡 |
| 专家 | 85% | 关键评估、边缘案例、替代方案 |
测验结果
当你完成一个测验时，你会看到你的分数和所有问题的摘要。击打 再试一次 通过间隔重复来加强你的学习。
查看您的进度
在克劳德代码中：
Show my quiz stats或者使用 quiz_stats 工具查看：
- 参加的测验总数
- 难度平均分
- 最近的会话历史
主题
转到设置（齿轮图标）配置主题：
| 主题 | 风格 |
|---|---|
| 黑客 | 矩阵绿色终端美学（默认） |
| 克劳德社区 | 温暖的克劳德橙色调 |
| 最小化 | 干净的蓝色GitHub风格 |
| 托马斯 | 绿色点缀+琥珀色按钮 |
您的首选项已保存在本地。
故障排除
测验不会生成吗？
- 确保
ANTHROPIC_API_KEY在MCP配置中设置 - 检查以下路径
packages/mcp/dist/index.js是绝对的
浏览器无法打开？
- 手动启动web UI：
pnpm dev - 导航至
http://localhost:9004/quiz/{session-id}
数据库错误？
- 数据库存储在
~/.quizz/data.db - MCP服务器和web UI共享此数据库
有趣的事实： SQLite是世界上部署最多的数据库——它位于您的手机、浏览器、汽车中，现在可以跟踪您的测验成绩。你的学习进度实际上是以与飞机飞行系统相同的格式存储的。没有压力。
面向开发者
看 设计.md 了解架构细节，或探索：
pnpm test # Run tests
pnpm lint # Check code style
pnpm typecheck # Type checking许可证
麻省理工学院