edu-agent-kit

An agent-powered knowledge base & content toolkit for educators. Build a local LLM-wiki for your teaching materials, generate deep instructional content from your own sources, and export/distribute it to Kahoot, Padlet, Nearpod, Wordwall, Wayground, Google Workspace, Google Classroom, and Firebase — from any MCP-capable agent.

🇹🇼 繁體中文說明：README.zh-TW.md ｜ 詳細安裝：docs/INSTALL.md ｜ API 申請：docs/API-SETUP.md

Works with Claude Code, Cursor, Codex, OpenCode, Antigravity, and any MCP client.

What it does

Native AI features in classroom tools produce shallow content, don't connect to agent workflows, and can't ingest your own materials. edu-agent-kit solves this end to end:

1. Local LLM-wiki — scaffold a knowledge base for your teaching materials (templated folders, agent memory/CLAUDE.md, dispatch commands), so an agent can orchestrate "material → knowledge base → generation → output."

2. Deep content generation — ingest files/URLs/images, align to Taiwan's 108課綱, and generate quizzes/lessons/boards that are validated and Bloom-depth-scored.

3. High-fidelity delivery — each platform gets its best supported path (official API where one exists, official import/export file otherwise) plus full Google Workspace + Classroom + Firebase output.

Four surfaces (cross-agent)

Platform support

⬇️ = produces a file you upload in one step (no brittle browser automation; ToS-safe).

Related MCP server: Educhain MCP Server

Quick start

# 1. Get the code & build
git clone https://github.com/FW1201/edu-agent-kit.git
cd edu-agent-kit
corepack enable pnpm
pnpm install && pnpm build

# 2. Scaffold your teaching knowledge base
node apps/cli/dist/index.js init --dir ~/my-teaching-wiki --template workflow \
  --name "您的稱呼" --grades "國中" --subjects "數學" --agents claude --google docs,classroom

# 3. (optional) Authorize Google — REQUIRES a one-time setup first, see below
node apps/cli/dist/index.js auth login

# 4. Check setup
node apps/cli/dist/index.js doctor

⚠️ Before step 3 works, you must create your own free Google OAuth client (one-time, ~5 min, in Google Cloud Console) and set GOOGLE_CLIENT_ID/GOOGLE_CLIENT_SECRET — there is no bundled default client. Full steps: docs/API-SETUP.md. auth login only handles the one-click consent/browser step after that; it does not replace it, and it is unrelated to any other Google login you may already have (browser, other MCP tools, etc.) — this toolkit's Google access is its own separate OAuth app.

Then connect your agent (below) and say things like "ingest raw/這課.pdf, generate a deep 8-question quiz for 國中, and build a Kahoot import file."

Tool catalog (60 tools)

• Content (11): content_ingest_source, content_ingest_image (handwriting/photos via your agent's vision), content_ingest_folder (batch), content_align_curriculum (real 108課綱 dataset), content_generate_quiz / _lesson / _board / _worksheet / _rubric / _lesson_plan / _parent_letter

• Knowledge base (3): wiki_list_templates, wiki_scaffold, wiki_status

• Word (.docx) (6): docx_create_lesson, docx_create_quiz (student/teacher versions), docx_create_worksheet, docx_create_rubric (criteria×levels grid), docx_create_lesson_plan, docx_create_parent_letter

• Interactive teach-apps (2): teachapp_build (quiz/flashcards), teachapp_deploy (Vercel/GitHub Pages)

• Padlet (5) · Google Classroom (13)

• Google Workspace (10): Docs / Slides / Forms / Sheets create + drive_create_folder / drive_upload_file / drive_set_sharing / drive_import_folder (batch import) / google_forms_read (read-back)

• Firebase (1): firebase_deploy_hosting

• Kahoot (3) · Wayground (1) · Wordwall (2) · Nearpod (1)

• Workflow (2): workflow_generate_and_distribute (generate → deliver → distribute), workflow_batch_distribute (same assignment across multiple Classroom courses, graded/due-date/topic aware)

Connect your agent

See docs/INSTALL.md for full per-agent steps. Replace /ABS/PATH with your clone path.

Claude Code (plugin — recommended):

/plugin marketplace add FW1201/edu-agent-kit
/plugin install edu-agent-kit@edu-agent-kit

Or as a plain MCP server: claude mcp add edu-agent-kit -- node /ABS/PATH/edu-agent-kit/apps/server/dist/index.js

Cursor / Codex / OpenCode / Antigravity: add the MCP server (node /ABS/PATH/edu-agent-kit/apps/server/dist/index.js) to the agent's MCP config — exact JSON/TOML for each in docs/INSTALL.md.

Remote/HTTP: TRANSPORT=http PORT=3000 node apps/server/dist/index.js → http://127.0.0.1:3000/mcp.

Credentials

All optional — missing keys only disable their own tools. Where to get each: docs/API-SETUP.md.

Web search is intentionally not a separate integration — use your agent's built-in web search and feed findings into content_ingest_source or directly into the conversation.

After you've created your own OAuth client and set GOOGLE_CLIENT_ID/GOOGLE_CLIENT_SECRET (see docs/API-SETUP.md — required, no client is bundled), the browser-consent step itself is one-time: edu-agent-kit auth login (or node packages/adapters/google-classroom/dist/auth-cli.js).

Limitations & ToS

• No browser automation. Kahoot/Wayground/Wordwall/Nearpod "create" produces an official import/export file you upload in one step — a deliberate, ToS-safe choice.

• The MCP server has no LLM of its own: content_generate_* returns a brief for your agent to author from, then validates + depth-scores the draft.

• Google/Kahoot/Padlet/Firebase live features need their respective (sometimes paid) accounts.

• The 108課綱 alignment dataset is an extensible seed.

Architecture

edu-agent-kit/                 pnpm monorepo
├── .claude-plugin/            plugin.json + marketplace.json
├── .mcp.json                  plugin MCP config
├── skills/                    5 educator skills (繁中)
├── packages/
│   ├── core/ sources/ mcp-shared/   models, ingestion, MCP utils
│   ├── wiki-kit/                     LLM-wiki scaffolder
│   └── adapters/
│       ├── google-shared/  google-classroom/  google-workspace/  firebase/
│       └── padlet/ kahoot/ wayground/ wordwall/ nearpod/
└── apps/
    ├── server/                single MCP server (60 tools)
    └── cli/                   edu-agent-kit CLI

Development

pnpm build      # build all packages
pnpm test       # unit tests
pnpm typecheck  # type-check

License

MIT © Kevin Wu (FW1201)