mathpack

mathpack

ブラウザーを開いたり、PDF エディターと格闘したりすることなく、幼稚園から高校 3 年生までの数学練習問題を印刷できます。mathpack は Mathter サービスと連携し、次の 3 つを提供します。現在利用できるスキルの一覧と、それぞれが対象とする学年、今月アカウントに残っているパック数の明確な回答、そしてパックそのものです。パックは出力フォルダーに直接 PDF として書き込まれ、すぐに印刷できます。

3 つのツール：

• list_skills — 利用できるスキルと、それぞれが対象とする学年を確認します。この一覧は公開されているため、この呼び出しでは API キーを送信しません。
• check_allowance — アカウントに残っているパック数、利用中のプラン、利用枠のリセット日を確認します。
• generate_worksheet_pack — 1 つのスキルと学年を指定してパックを作成します。テーマ、スタイル、難易度、タイトル、ワークシート数と問題数、解答、表紙とレッスンページ、解答例、単一の数値に焦点を当てたドリル、グラフ、時間制限モード、図、空白のグラフ、単位系、同一のパックを再現するシードを設定できます。必須項目は skill と grade のみです。

生成ファイルには、作成された時点に基づいて mathter-grade-<grade>-<skill>-<YYYY-MM-DD-HHmm>.pdf という名前が付けられます。同じ名前がすでに存在する場合は、-2、-3、…という接尾辞が追加されます。名前が重複することはなく、完成したパックが上書きされることもありません。ツールは書き込んだファイルの絶対パスのみを返します。

設定

export MATHTER_API_KEY="..."     # required for check_allowance and generate_worksheet_pack
export MATHTER_BASE_URL="https://mathter.ca"   # optional override
export MATHTER_OUT_DIR="/path/to/folder"       # optional; defaults to your Downloads folder

キーは利用枠の確認と生成の呼び出しでのみベアラーヘッダーとして送信されます。公開スキルエンドポイントに送信されることも、ファイルに保存されることも、応答に含まれることもありません。結果とエラーテキストはすべて、返される前にキーの値がフィルタリングされます。呼び出しが失敗した場合は、何が起きたのかを簡潔な文で返します。キーが受け付けられなかった、今月のクレジットを使い切った、そのスタイルはアカウントのプランで利用できない、Mathter がレート制限を適用している、レンダラーがビジー状態である、設定が拒否された、またはサービスに接続できない、といった内容です。

CLI

npx @reneturcios/mathpack list_skills
npx @reneturcios/mathpack check_allowance
npx @reneturcios/mathpack generate_worksheet_pack '{"skill":"multiplication","grade":4,"title":"Times tables","chart":"blank"}'
npx @reneturcios/mathpack --version

generate サブコマンドは、書き込んだ PDF の絶対パスを出力します。終了コード：成功時は 0、実行時エラー時は 1、使用方法のエラー時は 2 です。

MCP サーバー

npx -y @reneturcios/mathpack mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "mathpack": {
      "command": "npx",
      "args": ["-y", "@reneturcios/mathpack", "mcp"],
      "env": {
        "MATHTER_API_KEY": "..."
      }
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/mathpack
docker run --rm -e MATHTER_API_KEY="..." ghcr.io/cloudcorprecords/mathpack check_allowance

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch, fake writer, fake clock, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios