Quizlar

Quizlar MCP 服务

通过语音引导、FSRS 排程的抽认卡，内容来自 YouTube、PDF、网页或文本。测验自动评分。

Quizlar 的 MCP 服务让 Claude、Cursor、Cline、Windsurf 或任何兼容 MCP 的客户端能够：

• 根据 YouTube 视频、PDF、网页或粘贴的文本创建抽认卡组
• 运行自动评分的测验，使用与语音产品相同的 tier-1 精确匹配 → 语音匹配 → 大模型评分流程
• 使用 FSRS 间隔重复跟踪记忆情况——Quizlar 是权威排程器，每个答案都会更新实际记忆状态

此仓库是公开发现入口（面向 Official MCP Registry 的 server.json，以及供有此需求的客户端使用的 stdio 程序包）。托管的 MCP 服务本身为闭源，运行于 https://mcp.quizlar.app——支持 OAuth 的客户端使用 /mcp/，使用 apiKey Bearer 身份验证的客户端使用 /mcp-apikey/（本 README 中的所有代码片段均使用此路径）。

收录平台

• Official MCP Registry — io.github.quizlar/mcp-server v1.0.0
• Smithery — https://smithery.ai/servers/quizlar/quizlar

设置

1. 在 https://quizlar.app/settings/api-keys 创建 API 密钥（格式：sk-qz-<32 chars>）。
2. 选择下方的客户端并粘贴代码片段。

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "quizlar": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]",
        "https://mcp.quizlar.app/mcp-apikey/",
        "--header",
        "Authorization:Bearer ${QUIZLAR_API_KEY}"
      ],
      "env": { "QUIZLAR_API_KEY": "sk-qz-..." }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json — Windsurf 原生支持 Streamable HTTP，无需包装器：

{
  "mcpServers": {
    "quizlar": {
      "serverUrl": "https://mcp.quizlar.app/mcp-apikey/",
      "headers": { "Authorization": "Bearer ${QUIZLAR_API_KEY}" }
    }
  }
}

然后在 shell 中运行 export QUIZLAR_API_KEY=sk-qz-...。

Claude Desktop

打开 Settings → Connectors → “Add custom connector”：

• Name： Quizlar
• URL： https://mcp.quizlar.app/mcp-apikey/
• 添加标头 → Name： Authorization，Value： Bearer sk-qz-...

或者使用 mcp-remote 直接编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "quizlar": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]",
        "https://mcp.quizlar.app/mcp-apikey/",
        "--header",
        "Authorization:Bearer ${QUIZLAR_API_KEY}"
      ],
      "env": { "QUIZLAR_API_KEY": "sk-qz-..." }
    }
  }
}

Cline

编辑 cline_mcp_settings.json（Cline → Settings → MCP Servers → “Edit JSON”）：

{
  "mcpServers": {
    "quizlar": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]",
        "https://mcp.quizlar.app/mcp-apikey/",
        "--header",
        "Authorization:Bearer ${QUIZLAR_API_KEY}"
      ],
      "env": { "QUIZLAR_API_KEY": "sk-qz-..." }
    }
  }
}

详细步骤见 llms-install.md。

Smithery

npx -y @smithery/cli@latest install @quizlar/quizlar --client claude

将 claude 替换为 cursor、windsurf 等。Smithery 会引导你粘贴 API 密钥。

工具

22 个工具与学习者的操作一一对应：

• 构建抽认卡组： create_deck、create_deck_from_text、create_deck_from_youtube、create_cards_batch、get_job_status
• 测验： quiz_me（组合工具：一次调用即可完成构建和启动）、start_quiz、submit_answer、skip_question、end_quiz
• 浏览： list_decks、get_deck、list_cards、search_decks、search_cards、list_sessions
• 分析： get_progress、get_study_recommendations、get_learning_velocity、get_knowledge_gaps、get_retention_curves、get_card_difficulty_stats

身份验证

Bearer API 密钥（sk-qz-<32 chars>）是最简单的方式；上述所有代码片段中使用的 /mcp-apikey/ 挂载点都可直接接受 Bearer 标头，并跳过某些 stdio 桥接无法处理的 OAuth 握手。Quizlar 也在 https://mcp.quizlar.app/mcp/ 上提供完整的 OAuth 2.1，支持动态客户端注册和 PKCE（发现卡片位于 /.well-known/oauth-authorization-server），适用于偏好浏览器流程的客户端。

故障排查

• 每次调用工具都出现 401 Unauthorized — API 密钥缺失、输入有误或已撤销。请前往 https://quizlar.app/settings/api-keys 重新生成，并将完整的 sk-qz-… 值（包括前缀）粘贴到 Authorization: Bearer … 请求头中。
• 编辑配置后，客户端看不到 Quizlar 工具 — 完全重启客户端（大多数客户端不会热重载 MCP 配置）。对于 Claude Desktop，请从菜单栏退出；对于 Cursor / Windsurf / Cline，请关闭所有窗口。
• mcp-remote 启动失败 — 通常是 Node.js / npx 路径问题。在终端中运行 npx -y [email protected] --help，确认命令可正常解析；如果使用企业代理，请在客户端的 env 块中设置 HTTPS_PROXY，或使用 npm i -g [email protected] 全局安装 mcp-remote。
• 测验中途出现 429 / 配额错误 — 已达到免费套餐的每日限额。配额于 UTC 午夜重置；也可以前往 https://quizlar.app/settings/billing 升级。
• OAuth 回调始终未返回客户端 — 本地回环端口可能被阻止。请改用上文的 API 密钥流程；该流程完全绕过 OAuth。

如有其他未涵盖的问题，请在 https://github.com/quizlar/mcp-server/issues 提交问题，或发送邮件至 [email protected]。

链接

• 应用： https://quizlar.app
• 问题反馈： https://github.com/quizlar/mcp-server/issues
• Stdio 捆绑包源代码： bundle/（用于发布到 Smithery 及其他仅支持 stdio 的客户端）

许可证

此配置仓库采用 MIT 许可证。托管的 MCP 服务本身为专有软件。