mathpack

Name: mathpack
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords科研与教育01 周前更新

代码仓库

关于 mathpack

mathpack 是通过 Mathter 服务生成 K–12 年级可打印数学练习册的 MCP 服务和命令行工具，也可查询技能列表及账户每月剩余额度。

主要功能

01查看数学技能及适用年级
02查询每月练习册额度
03生成可自定义的练习册 PDF
04保存文件时避免覆盖已有练习册

适用场景

01查找适合某个年级的技能
02查看每月剩余练习册额度
03生成含答案或解题步骤的打印练习

MCP 相关

向 MCP 客户端提供查询技能、检查账户额度和生成练习册的工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-mathpack": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/mathpack"
      ]
    }
  }
}

启动命令npx -y @reneturcios/mathpack

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/mathpack0.1.0stdio

ocighcr.io/cloudcorprecords/mathpack:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

此工具无需参数。

详细介绍

mathpack

适用于 K 至 12 年级的可打印数学练习，无需打开浏览器，也不用费力操作 PDF 编辑器。mathpack 与 Mathter 服务交互，并提供三项内容：当前可用的技能列表及每项技能覆盖的年级、账户本月剩余的练习包数量，以及练习包本身——直接写入输出文件夹、可供打印的 PDF。

三种工具：

list_skills — 可用技能及每项技能覆盖的年级。此列表为公开信息，因此调用时不会发送 API 密钥。
check_allowance — 账户剩余的练习包数量、所用方案，以及额度重置日期。
generate_worksheet_pack — 为一项技能和一个年级生成练习包，可控制主题、风格、难度、标题、练习单和题目数量、答案、封面和课程页面、解题过程、单一数字专项练习、图表、限时模式、示意图、空白坐标图、单位制，以及可复现完全相同练习包的种子。只有 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

密钥只会作为额度查询和生成调用的 bearer 请求头发送——不会发送到公开的技能端点，不会写入文件，也不会出现在响应中：每条结果和错误文本在返回前都会过滤掉密钥值。调用失败时，响应会用一句简单的话说明原因：密钥未获接受、本月额度已用完、账户方案不支持该风格、Mathter 正在进行速率限制、渲染器繁忙、配置被拒绝，或服务无法访问。

命令行

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