Test Maker MCP Skill
AI エージェントから Test Maker で穴埋め・選択式テストを作るための MCP サーバーと Claude Code Skill。
「教科書のこのページから穴埋め問題を10問作って」「さっき作ったテストの問3だけ選択式に変えて」と 普段使っている AI にそのまま喋るだけ で、Test Maker にテストが保存されます。
これは何？
- Test Maker: 穴埋め・選択・多答・別解ありの自動採点テストを作成・配信できる Web サービス（https://www.test-maker.app/）
- MCP サーバー: Claude Code / Cursor / Claude Desktop / Codex CLI などから Test Maker にテストを作成・更新できる公式 MCP エンドポイント
- このリポジトリ: Claude Code 向けのスキル（プロンプト資産）を配布します。MCP サーバー本体は Test Maker 側で運用しており、URL (
https://api.test-maker.app/mcp) に繋ぐだけで使えます
できること（MCP 経由）
| 機能 | ツール |
|---|
| マークダウンから新規テスト作成 | create_examination |
| 既存テストを差分編集で上書き | update_examination |
| 既存テストの内容をマークダウンで取得 | get_examination |
| 自分のテスト一覧 + 枠状況 | list_my_examinations |
| 公開テスト用のタグ一覧 | list_examination_tags |
| プラン・枠状況の確認 | get_account_status |
| マークダウン記法の公式仕様 | get_test_maker_format_spec |
| 機能カタログ（何ができる／編集ページへの案内） | get_feature_catalog |
MCP で直接設定できない項目（デザインカスタマイズ、配信期間、回答者ログイン必須、画像アップロード、記述式問題など）は、各テストの編集ページから Web UI で設定 できます（今後 MCP 対応を検討）。
インストール
Claude Code
MCP サーバーとスキルの両方を追加:
# MCP サーバーを追加
claude mcp add test-maker --transport http https://api.test-maker.app/mcp
# このスキルをインストール
/plugin install github:TeXmeijin/test-maker-skill
初回にテストを作ろうとするとブラウザで OAuth 認可画面が開くので、Test Maker にログイン → 「許可」を押してください。以降は AI に 「〇〇のテスト作って」 と話すだけで動きます。
Cursor
MCP サーバー — .cursor/mcp.json または設定画面の MCP Servers に追加:
{
"mcpServers": {
"test-maker": {
"url": "https://api.test-maker.app/mcp"
}
}
}
スキル（任意）:
# CLI でインストール（gh v2.90.0 以降が必要 / 現時点は public preview）
gh skill install TeXmeijin/test-maker-skill test-maker --agent cursor
# または GUI: Settings → Rules → Add Rule → Remote Rule (GitHub)
# または手動: skills/test-maker/ を ~/.cursor/skills/ や ~/.agents/skills/ にコピー
Claude Desktop
claude_desktop_config.json に追加:
{
"mcpServers": {
"test-maker": {
"type": "http",
"url": "https://api.test-maker.app/mcp"
}
}
}
Codex CLI
MCP サーバー — ~/.codex/config.toml に追加:
[mcp_servers.test-maker]
url = "https://api.test-maker.app/mcp"
スキル（任意）:
# gh v2.90.0 以降が必要（public preview）
gh skill install TeXmeijin/test-maker-skill test-maker --agent codex
# 手動で入れる場合:
# git clone https://github.com/TeXmeijin/test-maker-skill.git /tmp/tms && \
# mkdir -p ~/.agents/skills && \
# cp -r /tmp/tms/skills/test-maker ~/.agents/skills/test-maker
その他の MCP クライアント
- URL:
https://api.test-maker.app/mcp
- Transport: Streamable HTTP
- Auth: OAuth 2.1（PKCE + Dynamic Client Registration 対応）
スキルについて: このリポジトリのスキルは Agent Skills 仕様（SKILL.md ベース）に準拠。Cursor / Codex CLI / Gemini CLI / Copilot など 30 超のクライアントが .agents/skills/ または ~/.agents/skills/ を読むので、skills/test-maker/ ディレクトリをそこに置けば動く。クロスエージェントで一括管理したいなら gh skill（gh v2.90.0 以降・public preview）で --agent claude-code|cursor|codex|copilot|gemini-cli|antigravity を指定してインストールできる。
使い方（例）
AI クライアントに以下のようなメッセージを投げると、MCP 経由でテストが作成されます。
日本史の江戸時代について、穴埋め問題を5問作って
生物の細胞小器官についての選択問題を作成したい。
ミトコンドリア・葉緑体・リボソーム・ゴルジ体を使った4択を3問。
さっき作った「江戸時代」テストの問3を選択式に変えて。選択肢は歴代将軍から4つ。
この PDF の内容から穴埋め問題を10問、別解ありにして作って。
作成が成功すると、AI が 回答ページ URL と 編集ページ URL を返します:
- 回答ページ: このリンクを配布すれば誰でも回答できる
- 編集ページ: Web UI でテストを開く。ここから追加の設定（デザイン・配信期間・ログイン必須など）が可能
料金・枠
| 項目 | 無料 | PRO |
|---|
| 非公開テスト作成数 | 3 件まで | 無制限 |
| 公開テスト作成数 | 10 件まで | 無制限 |
| 1 テストあたりの問題数 | 30 問まで | 無制限 |
| 解答履歴保存数 | 10 件まで | 300 件 |
枠に達したテストは MCP からは削除できません。削除は Test Maker の Web UI から 行ってください。
PRO のアップグレード: https://www.test-maker.app/m/payment
FAQ
スキルのインストールは必須？
必須ではないですが、インストールすると AI が Test Maker 用の最適な呼び出し順序・マークダウン記法・運用ルール を理解した状態で動くので、成功率が上がります。
スキル無しでも MCP サーバー単体で繋がります（AI がツール description を読んで適宜呼んでくれる）。
対応する AI クライアントは？
Streamable HTTP + OAuth 2.1 対応の MCP クライアントすべて。
動作確認済み: Claude Code（Anthropic）/ Cursor / Claude Desktop / Codex CLI。
記述式問題は作れる？
現時点では MCP 非対応です。編集ページ（Web UI）から追加してください。将来の MCP 対応を検討中。
オープンソース？
MCP サーバー本体: Test Maker のソースコードはオープンソースではありません。エンドポイントのみ公開しています。
このスキル (test-maker-skill): MIT ライセンスで公開。フォーク・改変自由。プロンプト改善の Pull Request 歓迎。
リンク
ライセンス
MIT — このリポジトリのみ。Test Maker 本体は別ライセンス。
TeXmeijin
TeXmeijin
