AI导哈

AI对话测验生成工具

Quizz MCP是一款将Claude对话转化为学习测验的工具，通过生成交互式测验帮助用户巩固知识、发现理解盲点并跟踪学习进度。

  • by ThoBustos
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 ThoBustos/quizz-mcp

使用说明

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

许可证

麻省理工学院

相关 MCP