studyriver-mcp

Study River — printable A4 practice sheets, made in a conversation with your AI.

An MCP server that typesets clean A4 drill PDFs (page 1 = problems, page 2 = answers). You talk to your AI ("20 multiplication facts and one logic puzzle, 15 minutes"); Study River does the layout. Everything runs locally — no account, no API key, nothing leaves your machine.

• 96 skills: math (addition through long division, decimals, fractions, 100-square grids, integers, equations), 8 logic-puzzle types × 3 levels, Japanese (hiragana/katakana/kanji tracing for all 1,026 school kanji, vertical-text reading), picture dictionary (143 words, English or Spanish), mazes
• Deterministic: the same spec + seed always reproduces the exact same sheet, so recording results only means noting which numbers went wrong
• Your data stays yours: the learning record is a local JSON file any AI can read
• Sheet labels in Japanese, English (labels: "en") or Spanish (labels: "es"); monochrome, made for home printers

PDFs are saved to ~/StudyRiver/ (override with STUDYRIVER_OUTPUT_DIR).

Setup

Requires Node.js 18+.

Claude Code

claude mcp add study-river -- npx -y studyriver-mcp

Or in your project's .mcp.json:

{
  "mcpServers": {
    "study-river": { "command": "npx", "args": ["-y", "studyriver-mcp"] }
  }
}

Claude Desktop

Settings → Developer → Edit config (claude_desktop_config.json):

{
  "mcpServers": {
    "study-river": { "command": "npx", "args": ["-y", "studyriver-mcp"] }
  }
}

One-click alternative (no Node.js): download the .mcpb bundle and double-click it.

Codex

In ~/.codex/config.toml:

[mcp_servers.study-river]
command = "npx"
args = ["-y", "studyriver-mcp"]

On Windows use command = "cmd", args = ["/c", "npx", "-y", "studyriver-mcp"] for any client.

Try it

Show me what drills StudyRiver can make

Make a 15-minute page: times tables plus one logic puzzle. English labels.

I got #3 and #5 wrong yesterday. What's next?

Tools

| tool | role | |---|---| | list_capabilities | catalog of everything it can generate (skillId system, spec rules) | | suggest_today | build today's sheet spec from selected skills and focus minutes | | preview_summary | dry-run check: contents, estimated minutes, page fill | | generate_drill | generate the A4 PDF (problems + answers) | | advance_position | compute the next difficulty step from marking results |

Guides, sample packs, data format (learning-record JSON) and the free web app: English · 日本語 · Español

日本語

Study River — 今日に合う一枚。AIとの会話からA4学習ドリルPDF（問題＋解答）を生成するMCPサーバーです。

• 会話で内容を指定:「九九を20問、余りのある割り算を10問」
• 全96種目: 算数・数学（たし算〜筆算わり算・小数・分数・100マス・正負の数・方程式）、ロジックパズル8形式×3レベル、こくご（かな・漢字なぞり全1,026字、縦書きの音読・視写・読解）、ピクチャーディクショナリー（英語/スペイン語143語）、迷路
• 決定論的生成: 同じ spec + seed は常に同じ紙面。だから結果の記録は「間違えた問題番号」だけでよい
• 学習記録はあなたの手元のJSON（学習カルテ）。サーバーには何も送られません
• 紙面はモノクロ2色・A4・家庭のプリンタ前提。固定ラベルは日本語/英語/スペイン語を選べます

セットアップ手順は上の英語節と同じです。くわしい使い方: https://eidendo.co.jp/studyriver/docs/mcp/

License

Code: MIT © Eidendo Inc. Bundled fonts: subsets of IPAex Gothic (IPA Font License v1.0) and Klee One (SIL Open Font License 1.1) — full license texts included in dist/assets/. Japanese tracing/reading sheets use the Klee One-derived textbook-style face so stroke endings (とめ・はね・はらい) follow handwriting conventions.