Quizlar

Quizlar MCP サーバー

YouTube、PDF、ウェブ、またはテキストから、音声主導でFSRSに基づきスケジュールされるフラッシュカードを作成できます。クイズは自動採点されます。

QuizlarのMCPサーバーを使うと、Claude、Cursor、Cline、Windsurf、またはMCP互換クライアントで次のことができます。

• YouTube動画、PDF、ウェブページ、または貼り付けたテキストからフラッシュカードのデッキを作成する
• 音声プロダクトを支えるものと同じ、完全一致 → 音声的類似 → LLM採点のパイプラインで自動採点クイズを実施する
• FSRS間隔反復で記憶を追跡する — Quizlarが正式なスケジューラーとなり、回答するたびに実際の記憶状態が更新されます

このリポジトリは公開ディスカバリー用のエントリーポイントです（公式MCPレジストリ向けのserver.jsonと、それを必要とするクライアント向けのstdioバンドルを提供します）。ホスト型MCPサーバー自体はクローズドソースで、https://mcp.quizlar.appで稼働します。OAuth対応クライアントには/mcp/を、apiKey Bearer認証には/mcp-apikey/を使用します（このREADME内のすべてのスニペットで使用）。

掲載先

• 公式MCPレジストリ — 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}" }
    }
  }
}

その後、シェルでexport QUIZLAR_API_KEY=sk-qz-...を実行します。

Claude Desktop

「Settings」→「Connectors」→「Add custom connector」を開きます。

• 名前： Quizlar
• URL： https://mcp.quizlar.app/mcp-apikey/
• ヘッダーを追加 → 名前： Authorization、値： 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キーを貼り付けます。

ツール

学習者の動詞に1対1で対応する22個のツールがあります。

• デッキを作成： create_deck、create_deck_from_text、create_deck_from_youtube、create_cards_batch、get_job_status
• クイズ： quiz_me（複合ツール：1回の呼び出しで作成と開始を実行）、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/でDynamic Client Registration + PKCEを含むOAuth 2.1全機能を公開しています（ディスカバリーカードは/.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 の午前 0 時にリセットされます。または、https://quizlar.app/settings/billing でアップグレードしてください。
• OAuth コールバックがクライアントに戻らない — ループバックポートがブロックされている可能性があります。上記の API キー方式に切り替えてください。OAuth を完全に回避できます。

ここに記載のない問題については、https://github.com/quizlar/mcp-server/issues で issue を作成するか、[email protected] までメールでお問い合わせください。

リンク

• アプリ： https://quizlar.app
• Issue： https://github.com/quizlar/mcp-server/issues
• Stdio バンドルのソース： bundle/（Smithery やその他の stdio のみのクライアントへの公開に使用）

ライセンス

この設定リポジトリは MIT ライセンスです。ホストされている MCP サーバー自体はプロプライエタリです。