考試雲 examscloud

examscloud MCP

お使いの AI ツール（Claude Code、Codex、claude.ai…）で、考試雲 examscloud の過去問題、公式解答、AI 作成の解答例、学習記録を利用できます。

この repo に含まれるのはインストール設定、Claude Code plugin、サンプルのみです。サーバーは examscloud.net が提供しており、ここに問題データベースや秘密鍵はありません。

ひとことでインストール（推奨）

以下の文を Claude Code または Codex のチャット欄に貼り付けてください。どちらを使っているかを見分ける必要はありません。AI が自動で判断してインストールします。

請幫我把「考試雲 examscloud」加成你的 MCP server（HTTP 傳輸，網址 https://examscloud.net/mcp）。
- 如果你是 Claude Code：在終端機執行 `claude mcp add --transport http --scope user examscloud https://examscloud.net/mcp`，然後提醒我輸入 /mcp、選 examscloud 登入授權。
- 如果你是 Codex：在終端機執行 `codex mcp add examscloud --url https://examscloud.net/mcp`，再執行 `codex mcp login examscloud`（會開瀏覽器讓我登入並按同意）。
- 若已經有同名的 examscloud 設定，先問我要不要覆蓋。不要向我要密碼或 token，也不要改用其他網址。
授權完成後，呼叫 examscloud 的 search_questions 搜尋「消滅時效」取 3 題，確認可以使用。

ブラウザーでの認証を避けたい場合は、examscloud.net の会員センターで「AI 工具連線」を開き、「產生我的一段話」を押してください。個人用 token が含まれた文が生成されるので、コピーして貼り付けるだけで完了します（token は一度しか表示されません。共有しないでください）。AI に手順をすべて読ませたい場合は、INSTALL.md に従ってインストールするよう依頼してください。

初回使用時、ツールはブラウザーを開き、考試雲にログインして「同意」を押すよう求めます。パスワードや token をコピーする必要はありません。

手動インストール

ツール	方法
Claude Code	claude mcp add --transport http examscloud https://examscloud.net/mcp、または plugin をインストール：/plugin marketplace add lkm543/examscloud-mcp → /plugin install examscloud@examscloud、続けて /mcp でログイン
Codex	codex mcp add examscloud --url https://examscloud.net/mcp、続けて codex mcp login examscloud
claude.ai／その他のカスタムコネクターに対応するツール	カスタムコネクターを追加し、URL に https://examscloud.net/mcp を指定
ログインせずに試す	https://examscloud.net/mcp/public に接続（過去問題と公式解答のみ利用可能で、利用上限は低めです）

コマンドの構文は各ツールの公式ドキュメントを参照してください。設定例は codex/config.toml.example をご覧ください。

できること

ツール	説明	必要条件
search_questions、get_question、get_answer、get_paper	過去問題の検索、個別問題の閲覧（デフォルトでは解答なし）、公式解答、ページ単位での試験全体の閲覧	ログイン不要で利用可能
get_draft、get_concept_card、get_corrections	AI 作成の解答例全文、概念カード、修正履歴	ログイン（アカウントの解答例利用枠を消費）
start_practice、get_practice_questions、submit_practice	AI 内で試験全体を練習して提出・採点し、結果をウェブサイトの解答記録と間違い問題帳に保存	ログイン
get_review_queue、list_wrong_questions、update_wrong_question	今日の復習、間違い問題帳、習得済みの記録	ログイン
report_question	問題の誤字、画像の欠落、選択肢や解答の誤りを報告（1 人につき 1 日 20 問まで）	ログイン
list_attempts、get_study_report、export_my_data	解答記録、学習統計、自分のデータをページ単位でエクスポートして分析	ログイン

Claude Code plugin には、/examscloud:practice、/examscloud:review、/examscloud:study-plan、/examscloud:wrong-notes の 4 つのコマンドも付属しています。同じワークフローは MCP プロンプト（practice、review、study-plan、wrong-notes）でも利用できるため、Codex、claude.ai など plugin に対応していないツールでも使えます。

提出時に未解答の問題は、ウェブ版の模擬試験と同様に不正解として採点され、間違い問題帳に追加されます。

自分のデータを使った分析や二次開発

examples/ には、Python 標準ライブラリのみを使ったサンプル（間違えた問題の科目別分布の集計など）があります。プログラムは個人用 token（会員センターの「AI 工具連線」で作成）を使って https://examscloud.net/mcp を呼び出します。token は環境変数 EXAMSCLOUD_MCP_TOKEN に設定してください。Git にコミットするファイルには記載しないでください。

利用規約

• 自分の解答記録と間違い問題の記録：用途の制限はありません。
• 過去問題と公式解答：個人の学習と分析に限ります。引用する際は「資料來源：考試雲 examscloud」と記載し、問題の URL を添えてください。問題ごと、試験ごとに利用枠の範囲内で取得してください。科目全体、年度全体、データベース全体のダウンロードは提供していません。プログラムによる大量取得はご遠慮ください。
• AI 作成の解答例と概念カード：AI によって生成されており、誤りを含む可能性があります。個人利用に限り、再配布は禁止です。
• 正式な規約は examscloud.net の告知に従ってください。規約に違反した token や認証は取り消される場合があります。

examscloud.net の会員センター「AI 工具連線」では、認証済みのツールと token をいつでも確認・取り消すことができます。

ライセンス

この repo の設定ファイル、plugin、サンプルプログラムには MIT を適用しています。このライセンスは、サービスを通じて取得した問題、解答、解答例には適用されません。