education-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SceneView Tools
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/PRIVACY.md

@@ -0,0 +1,53 @@
+# Privacy Policy — education-mcp
+
+**Effective date:** March 26, 2026
+**Provider:** SceneView Tools
+
+## 1. Overview
+
+The `education-mcp` MCP server processes educational content generation requests locally. This policy describes how we handle data.
+
+## 2. Data We Process
+
+When you use the Service, we process:
+- **Input parameters:** Topic names, subject areas, difficulty levels, and other configuration you provide to generate content.
+- **No personal data required:** The Service does not require or collect personal information such as names, email addresses, student records, or institutional data.
+
+## 3. Data We Do NOT Collect
+
+- We do NOT collect student personally identifiable information (PII).
+- We do NOT store input parameters or generated content.
+- We do NOT use cookies or tracking mechanisms.
+- We do NOT sell or share any data with third parties.
+- We do NOT collect analytics or usage telemetry in the open-source version.
+
+## 4. Data Processing
+
+- All content generation happens locally on your machine or infrastructure.
+- No data is transmitted to external servers in the open-source version.
+- The Pro tier API may process requests server-side; in that case, inputs are processed in memory only and not stored after response delivery.
+
+## 5. FERPA / COPPA / GDPR Compliance
+
+- The Service is designed to be compatible with FERPA requirements as it does not process student education records.
+- The Service does not knowingly collect data from children under 13 (COPPA).
+- For GDPR: no personal data is collected or processed. The Service operates as a local tool.
+
+## 6. Third-Party Services
+
+The open-source version of this Service makes no external API calls. The Pro tier may use:
+- Stripe for payment processing (subject to [Stripe's Privacy Policy](https://stripe.com/privacy)).
+
+## 7. Security
+
+- The Service runs as a local MCP server with no network exposure by default.
+- No credentials, tokens, or secrets are stored.
+- The source code is open for security audit under the MIT license.
+
+## 8. Changes
+
+We may update this policy as the Service evolves. Changes will be noted in the repository's changelog.
+
+## 9. Contact
+
+For privacy questions: open an issue at https://github.com/mcp-tools-lab/education-mcp/issues

package/README.md

@@ -0,0 +1,144 @@
+# education-mcp
+
+AI-powered education tools for teachers and students via the [Model Context Protocol](https://modelcontextprotocol.io).
+
+Generate quizzes, lesson plans, flashcards, concept explanations, exercises, and grading rubrics — all from your AI assistant.
+
+## Tools
+
+| Tool | Description |
+|---|---|
+| `generate_quiz` | Multiple choice, true/false, and fill-in-blank quizzes from any topic |
+| `generate_lesson_plan` | Structured lesson plans with Bloom's taxonomy objectives, timed activities, assessment, and differentiation |
+| `generate_flashcards` | Spaced repetition flashcard decks with hints, tags, and Leitner review schedules |
+| `explain_concept` | Age-appropriate explanations at beginner/intermediate/expert levels with analogies and examples |
+| `generate_exercise` | Math, physics, chemistry, biology, and CS exercises with step-by-step solutions |
+| `grade_rubric` | Grading rubrics for essays, presentations, projects, lab reports, and code assignments |
+
+## Quick Start
+
+### With Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "education": {
+      "command": "npx",
+      "args": ["-y", "education-mcp"]
+    }
+  }
+}
+```
+
+### With any MCP client
+
+```bash
+npx education-mcp
+```
+
+## Examples
+
+### Generate a Quiz
+
+```
+generate_quiz({
+  topic: "photosynthesis",
+  question_count: 10,
+  question_types: ["multiple_choice", "true_false"],
+  difficulty: "medium"
+})
+```
+
+### Create a Lesson Plan
+
+```
+generate_lesson_plan({
+  topic: "fractions",
+  subject: "Mathematics",
+  grade_level: "5th grade",
+  duration_minutes: 45,
+  include_homework: true
+})
+```
+
+### Make Flashcards
+
+```
+generate_flashcards({
+  topic: "Spanish irregular verbs",
+  card_count: 20,
+  difficulty: "medium",
+  include_hints: true
+})
+```
+
+### Explain a Concept
+
+```
+explain_concept({
+  concept: "gravity",
+  level: "beginner",
+  age_group: "elementary",
+  include_analogy: true
+})
+```
+
+### Generate Exercises
+
+```
+generate_exercise({
+  topic: "kinematics",
+  subject: "physics",
+  exercise_count: 5,
+  difficulty: "hard",
+  show_steps: true
+})
+```
+
+### Create a Grading Rubric
+
+```
+grade_rubric({
+  assignment_title: "Research Paper on Climate Change",
+  assignment_type: "essay",
+  total_points: 100,
+  scale_levels: 4
+})
+```
+
+## Pricing
+
+| | Free | Pro ($9.99/month) |
+|---|---|---|
+| Calls per month | 30 | Unlimited |
+| All 6 tools | Yes | Yes |
+| Custom templates | No | Yes |
+| Priority generation | No | Yes |
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+### Run tests
+
+```bash
+npm test              # single run
+npm run test:watch    # watch mode
+npm run test:coverage # with coverage
+```
+
+## Disclaimer
+
+This tool generates educational content for reference purposes. Teachers should review all generated content before classroom use. This is not a substitute for professional curriculum development.
+
+## License
+
+MIT - SceneView Tools
+
+See [TERMS.md](TERMS.md) and [PRIVACY.md](PRIVACY.md) for full legal details.

package/TERMS.md

@@ -0,0 +1,57 @@
+# Terms of Service — education-mcp
+
+**Effective date:** March 26, 2026
+**Provider:** SceneView Tools
+
+## 1. Acceptance
+
+By using the `education-mcp` MCP server ("Service"), you agree to these Terms of Service.
+
+## 2. Description
+
+The Service provides AI-assisted education tools including quiz generation, lesson planning, flashcard creation, concept explanation, exercise generation, and rubric creation via the Model Context Protocol (MCP).
+
+## 3. Educational Disclaimer
+
+**This Service generates educational content for reference purposes only.**
+
+- All generated content should be reviewed by a qualified educator before use in classrooms.
+- The Service is not a substitute for professional curriculum development, instructional design, or pedagogical expertise.
+- Generated assessments, rubrics, and exercises are starting points and should be adapted to specific student needs, local standards, and institutional requirements.
+- The Service does not guarantee the accuracy, completeness, or appropriateness of any generated content.
+
+## 4. Pricing
+
+- **Free tier:** 30 calls per month across all tools.
+- **Pro tier:** $9.99/month for unlimited calls with enhanced features.
+- Pricing is subject to change with 30 days notice.
+
+## 5. Acceptable Use
+
+You agree NOT to:
+- Use the Service to generate content that promotes harm, discrimination, or misinformation.
+- Redistribute generated content as your own proprietary curriculum without review and adaptation.
+- Attempt to circumvent rate limits or access controls.
+- Use the Service for automated scraping or bulk content generation for resale.
+
+## 6. Intellectual Property
+
+- Generated content is provided for your use and may be freely modified and distributed.
+- The Service's source code is licensed under MIT.
+- You retain all rights to content you create by modifying or building upon generated output.
+
+## 7. Privacy
+
+See our [Privacy Policy](PRIVACY.md) for information about data handling.
+
+## 8. Limitation of Liability
+
+THE SERVICE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IN NO EVENT SHALL THE PROVIDER BE LIABLE FOR ANY DAMAGES ARISING FROM THE USE OF GENERATED EDUCATIONAL CONTENT, INCLUDING BUT NOT LIMITED TO INACCURATE ASSESSMENT ITEMS, INAPPROPRIATE DIFFICULTY LEVELS, OR PEDAGOGICAL UNSUITABILITY.
+
+## 9. Changes
+
+We may update these Terms at any time. Continued use after changes constitutes acceptance.
+
+## 10. Contact
+
+For questions: open an issue at https://github.com/mcp-tools-lab/education-mcp/issues

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * education-mcp — AI-powered education tools via MCP.
+ *
+ * Tools: generate_quiz, generate_lesson_plan, generate_flashcards,
+ *        explain_concept, generate_exercise, grade_rubric
+ *
+ * Author: SceneView Tools
+ * License: MIT
+ *
+ * DISCLAIMER: This tool generates educational content for reference purposes.
+ * Teachers should review all generated content before use in classrooms.
+ * This is not a substitute for professional curriculum development.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG"}

package/dist/index.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * education-mcp — AI-powered education tools via MCP.
+ *
+ * Tools: generate_quiz, generate_lesson_plan, generate_flashcards,
+ *        explain_concept, generate_exercise, grade_rubric
+ *
+ * Author: SceneView Tools
+ * License: MIT
+ *
+ * DISCLAIMER: This tool generates educational content for reference purposes.
+ * Teachers should review all generated content before use in classrooms.
+ * This is not a substitute for professional curriculum development.
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("education-mcp server started on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;AACzD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Server for education-mcp.
+ *
+ * Registers all 6 education tools and exposes them via the Model Context Protocol.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAepE,wBAAgB,YAAY,IAAI,SAAS,CA8NxC"}

package/dist/server.js

@@ -0,0 +1,191 @@
+/**
+ * MCP Server for education-mcp.
+ *
+ * Registers all 6 education tools and exposes them via the Model Context Protocol.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { generateQuiz, generateLessonPlan, generateFlashcards, explainConcept, generateExercise, gradeRubric, } from "./tools/index.js";
+import { RATE_LIMITS } from "./types.js";
+// Re-export zod from the SDK for schema definitions
+// The MCP SDK bundles zod, so we use it from there.
+export function createServer() {
+    const server = new McpServer({
+        name: "education-mcp",
+        version: "1.0.0",
+        description: "AI-powered education tools for teachers and students. Generate quizzes, lesson plans, flashcards, concept explanations, exercises, and grading rubrics.",
+    });
+    // ── generate_quiz ──────────────────────────────────────────────────────────
+    server.tool("generate_quiz", "Create a quiz from a topic with multiple choice, true/false, and fill-in-blank questions. Perfect for formative assessment, test prep, and homework.", {
+        topic: z.string().min(1).describe("The topic to generate questions about (e.g., 'photosynthesis', 'World War II', 'quadratic equations')"),
+        question_count: z.number().int().min(1).max(50).optional().describe("Number of questions (default: 5, max: 50)"),
+        question_types: z
+            .array(z.enum(["multiple_choice", "true_false", "fill_in_blank"]))
+            .optional()
+            .describe("Types of questions to include (default: all three)"),
+        difficulty: z.enum(["easy", "medium", "hard"]).optional().describe("Difficulty level (default: medium)"),
+        subject: z.string().optional().describe("Subject area (auto-detected if omitted)"),
+        age_group: z
+            .enum(["elementary", "middle_school", "high_school", "college", "adult"])
+            .optional()
+            .describe("Target age group (default: inferred from difficulty)"),
+    }, async (args) => {
+        try {
+            const result = generateQuiz(args);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── generate_lesson_plan ───────────────────────────────────────────────────
+    server.tool("generate_lesson_plan", "Create a structured lesson plan with learning objectives (Bloom's taxonomy), timed activities, assessment strategies, and differentiation. Follows the Madeline Hunter model.", {
+        topic: z.string().min(1).describe("Lesson topic (e.g., 'fractions', 'the water cycle')"),
+        subject: z.string().min(1).describe("Subject area (e.g., 'Mathematics', 'Science')"),
+        grade_level: z.string().min(1).describe("Grade level (e.g., '5th grade', 'AP Biology')"),
+        duration_minutes: z.number().int().min(15).max(180).optional().describe("Lesson duration in minutes (default: 45)"),
+        objectives_count: z.number().int().min(1).max(6).optional().describe("Number of learning objectives (default: 3)"),
+        include_standards: z.boolean().optional().describe("Include standards alignment (default: true)"),
+        include_homework: z.boolean().optional().describe("Include homework assignment (default: false)"),
+    }, async (args) => {
+        try {
+            const result = generateLessonPlan(args);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── generate_flashcards ────────────────────────────────────────────────────
+    server.tool("generate_flashcards", "Create a spaced repetition flashcard deck from a topic. Cards include front/back, optional hints, difficulty tags, and a review schedule based on the Leitner system.", {
+        topic: z.string().min(1).describe("Topic for the flashcard deck (e.g., 'Spanish vocabulary', 'cell biology')"),
+        card_count: z.number().int().min(1).max(100).optional().describe("Number of flashcards (default: 10, max: 100)"),
+        difficulty: z.enum(["easy", "medium", "hard"]).optional().describe("Maximum difficulty level (default: medium)"),
+        include_hints: z.boolean().optional().describe("Include study hints on cards (default: true)"),
+        tags: z.array(z.string()).optional().describe("Custom tags for organizing cards"),
+    }, async (args) => {
+        try {
+            const result = generateFlashcards(args);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── explain_concept ────────────────────────────────────────────────────────
+    server.tool("explain_concept", "Explain a concept at different levels (beginner/intermediate/expert) and for different age groups. Includes analogies, examples, prerequisites, and common misconceptions.", {
+        concept: z.string().min(1).describe("The concept to explain (e.g., 'gravity', 'photosynthesis', 'machine learning')"),
+        level: z.enum(["beginner", "intermediate", "expert"]).optional().describe("Explanation depth (default: beginner)"),
+        age_group: z
+            .enum(["elementary", "middle_school", "high_school", "college", "adult"])
+            .optional()
+            .describe("Target age group for vocabulary and examples (default: high_school)"),
+        include_analogy: z.boolean().optional().describe("Include a relatable analogy (default: true)"),
+        include_examples: z.boolean().optional().describe("Include practical examples (default: true)"),
+        max_length: z.number().int().min(50).max(2000).optional().describe("Maximum word count (default: 500)"),
+    }, async (args) => {
+        try {
+            const result = explainConcept(args);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── generate_exercise ──────────────────────────────────────────────────────
+    server.tool("generate_exercise", "Generate math, physics, chemistry, biology, or computer science exercises with step-by-step solutions, hints, and common mistakes. Great for homework and practice sets.", {
+        topic: z.string().min(1).describe("Exercise topic (e.g., 'linear equations', 'kinematics', 'DNA replication')"),
+        subject: z
+            .enum(["math", "physics", "chemistry", "biology", "computer_science"])
+            .describe("Subject area for the exercises"),
+        exercise_count: z.number().int().min(1).max(20).optional().describe("Number of exercises (default: 3, max: 20)"),
+        difficulty: z.enum(["easy", "medium", "hard"]).optional().describe("Difficulty level (default: medium)"),
+        include_hints: z.boolean().optional().describe("Include hints for each exercise (default: true)"),
+        show_steps: z.boolean().optional().describe("Show step-by-step solutions (default: true)"),
+    }, async (args) => {
+        try {
+            const result = generateExercise(args);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── grade_rubric ───────────────────────────────────────────────────────────
+    server.tool("grade_rubric", "Create a detailed grading rubric for an assignment. Supports essays, presentations, projects, lab reports, and code assignments. Rubrics include weighted criteria with level descriptors.", {
+        assignment_title: z.string().min(1).describe("Title of the assignment (e.g., 'Research Paper on Climate Change')"),
+        assignment_type: z
+            .enum(["essay", "presentation", "project", "lab_report", "code"])
+            .describe("Type of assignment"),
+        criteria_count: z.number().int().min(2).max(10).optional().describe("Number of grading criteria (default: 4)"),
+        total_points: z.number().int().min(10).max(1000).optional().describe("Total points possible (default: 100)"),
+        scale_levels: z.number().int().min(3).max(6).optional().describe("Number of performance levels (default: 4, e.g., Beginning/Developing/Proficient/Exemplary)"),
+        subject: z.string().optional().describe("Subject area for context-specific criteria"),
+    }, async (args) => {
+        try {
+            const result = gradeRubric(args);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: "text", text: `Error: ${err.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── Pricing resource ───────────────────────────────────────────────────────
+    server.resource("pricing", "education://pricing", async () => ({
+        contents: [
+            {
+                uri: "education://pricing",
+                mimeType: "application/json",
+                text: JSON.stringify({
+                    free_tier: {
+                        calls_per_month: RATE_LIMITS.freeMonthlyLimit,
+                        features: "All 6 tools with standard output",
+                    },
+                    pro_tier: {
+                        price_usd: RATE_LIMITS.proPriceUsd,
+                        period: "month",
+                        calls_per_month: "unlimited",
+                        features: "All 6 tools, priority generation, extended output, custom templates",
+                    },
+                }),
+            },
+        ],
+    }));
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,oDAAoD;AACpD,oDAAoD;AAEpD,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,OAAO;QAChB,WAAW,EACT,yJAAyJ;KAC5J,CAAC,CAAC;IAEH,8EAA8E;IAE9E,MAAM,CAAC,IAAI,CACT,eAAe,EACf,sJAAsJ,EACtJ;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uGAAuG,CAAC;QAC1I,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QAChH,cAAc,EAAE,CAAC;aACd,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,iBAAiB,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC;aACjE,QAAQ,EAAE;aACV,QAAQ,CAAC,oDAAoD,CAAC;QACjE,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QACxG,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QAClF,SAAS,EAAE,CAAC;aACT,IAAI,CAAC,CAAC,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;aACxE,QAAQ,EAAE;aACV,QAAQ,CAAC,sDAAsD,CAAC;KACpE,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;YAClC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;gBACnE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8EAA8E;IAE9E,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,+KAA+K,EAC/K;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qDAAqD,CAAC;QACxF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+CAA+C,CAAC;QACpF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+CAA+C,CAAC;QACxF,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;QACnH,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;QAClH,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QACjG,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;KAClG,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACxC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;gBACnE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8EAA8E;IAE9E,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,uKAAuK,EACvK;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2EAA2E,CAAC;QAC9G,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QAChH,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;QAChH,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QAC9F,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;KAClF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACxC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;gBACnE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8EAA8E;IAE9E,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,4KAA4K,EAC5K;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gFAAgF,CAAC;QACrH,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QAClH,SAAS,EAAE,CAAC;aACT,IAAI,CAAC,CAAC,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;aACxE,QAAQ,EAAE;aACV,QAAQ,CAAC,qEAAqE,CAAC;QAClF,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QAC/F,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;QAC/F,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;KACxG,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YACpC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;gBACnE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8EAA8E;IAE9E,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,0KAA0K,EAC1K;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4EAA4E,CAAC;QAC/G,OAAO,EAAE,CAAC;aACP,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;aACrE,QAAQ,CAAC,gCAAgC,CAAC;QAC7C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QAChH,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QACxG,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;QACjG,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;KAC3F,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACtC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;gBACnE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8EAA8E;IAE9E,MAAM,CAAC,IAAI,CACT,cAAc,EACd,4LAA4L,EAC5L;QACE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oEAAoE,CAAC;QAClH,eAAe,EAAE,CAAC;aACf,IAAI,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;aAChE,QAAQ,CAAC,oBAAoB,CAAC;QACjC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QAC9G,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QAC5G,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4FAA4F,CAAC;QAC9J,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;KACtF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YACjC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;gBACnE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,8EAA8E;IAE9E,MAAM,CAAC,QAAQ,CACb,SAAS,EACT,qBAAqB,EACrB,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,qBAAqB;gBAC1B,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,SAAS,EAAE;wBACT,eAAe,EAAE,WAAW,CAAC,gBAAgB;wBAC7C,QAAQ,EAAE,kCAAkC;qBAC7C;oBACD,QAAQ,EAAE;wBACR,SAAS,EAAE,WAAW,CAAC,WAAW;wBAClC,MAAM,EAAE,OAAO;wBACf,eAAe,EAAE,WAAW;wBAC5B,QAAQ,EAAE,qEAAqE;qBAChF;iBACF,CAAC;aACH;SACF;KACF,CAAC,CACH,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/explain-concept.d.ts

@@ -0,0 +1,9 @@
+/**
+ * explain_concept — Explain a concept at different audience levels and age groups.
+ *
+ * Generates structured explanations with analogies, examples, prerequisites,
+ * and common misconceptions.
+ */
+import type { ExplainConceptInput, ConceptExplanation } from "../types.js";
+export declare function explainConcept(input: ExplainConceptInput): ConceptExplanation;
+//# sourceMappingURL=explain-concept.d.ts.map

package/dist/tools/explain-concept.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-concept.d.ts","sourceRoot":"","sources":["../../src/tools/explain-concept.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAGnB,MAAM,aAAa,CAAC;AAwIrB,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,kBAAkB,CAgD7E"}