sad-mcp 0.1.5 → 0.1.7

package/dist/index.js

@@ -7,7 +7,7 @@ import { trackServerStart } from "./tracking.js";
 async function main() {
     // Connect to Claude Desktop IMMEDIATELY — no blocking auth here
     // Auth happens lazily on first Drive API call
-    const server = new Server({ name: "sad-mcp", version: "0.1.5" }, {
+    const server = new Server({ name: "sad-mcp", version: "0.1.7" }, {
         capabilities: {
             tools: {},
             prompts: {},

package/dist/text-cache.d.ts

@@ -0,0 +1,6 @@
+export interface TextCacheEntry {
+    modifiedTime?: string;
+    text: string;
+}
+export declare function loadTextCache(): Record<string, TextCacheEntry>;
+export declare function saveTextEntry(fileId: string, entry: TextCacheEntry): void;

package/dist/text-cache.js

@@ -0,0 +1,44 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+const TEXT_CACHE_DIR = join(homedir(), ".sad-mcp", "text-cache");
+const TEXT_CACHE_INDEX = join(TEXT_CACHE_DIR, "index.json");
+function ensureDir() {
+    if (!existsSync(TEXT_CACHE_DIR)) {
+        mkdirSync(TEXT_CACHE_DIR, { recursive: true });
+    }
+}
+function loadIndex() {
+    try {
+        return JSON.parse(readFileSync(TEXT_CACHE_INDEX, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+function saveIndex(index) {
+    ensureDir();
+    writeFileSync(TEXT_CACHE_INDEX, JSON.stringify(index, null, 2));
+}
+export function loadTextCache() {
+    const index = loadIndex();
+    const result = {};
+    for (const [fileId, entry] of Object.entries(index)) {
+        try {
+            const text = readFileSync(join(TEXT_CACHE_DIR, entry.textFile), "utf-8");
+            result[fileId] = { modifiedTime: entry.modifiedTime, text };
+        }
+        catch {
+            // Skip missing text files
+        }
+    }
+    return result;
+}
+export function saveTextEntry(fileId, entry) {
+    ensureDir();
+    const textFile = `${fileId}.txt`;
+    writeFileSync(join(TEXT_CACHE_DIR, textFile), entry.text, "utf-8");
+    const index = loadIndex();
+    index[fileId] = { modifiedTime: entry.modifiedTime, textFile };
+    saveIndex(index);
+}

package/dist/tools.js

@@ -1,19 +1,29 @@
 import { ListToolsRequestSchema, CallToolRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { listAllFiles, downloadFile, categorizeFile } from "./drive.js";
 import { extractText, isExtractable } from "./text-extract.js";
+import { loadTextCache, saveTextEntry } from "./text-cache.js";
 import { trackToolCall } from "./tracking.js";
-// In-memory text cache for search (populated on first search)
+// In-memory text cache for search (populated from disk cache + fresh extractions)
 const textCache = new Map();
 async function ensureTextCache() {
     if (textCache.size > 0)
         return;
     const files = await listAllFiles();
     const extractableFiles = files.filter(isExtractable);
+    const diskCache = loadTextCache();
     for (const file of extractableFiles) {
         try {
+            // Check disk cache — hit if file hasn't changed
+            const cached = diskCache[file.id];
+            if (cached && cached.modifiedTime === file.modifiedTime) {
+                textCache.set(file.id, { file, text: cached.text });
+                continue;
+            }
+            // Cache miss — download and extract
             const buffer = await downloadFile(file);
             const text = await extractText(file, buffer);
             textCache.set(file.id, { file, text });
+            saveTextEntry(file.id, { modifiedTime: file.modifiedTime, text });
         }
         catch {
             // Skip files that fail to download/extract
@@ -62,6 +72,24 @@ export function registerToolHandlers(server) {
                     },
                 },
             },
+            {
+                name: "quiz",
+                description: "Generate a practice quiz on a course topic. Searches course materials for relevant content and returns it with instructions for Claude to create quiz questions. Use when a student wants to test their knowledge.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        topic: {
+                            type: "string",
+                            description: "The topic to quiz on (e.g., 'use case diagrams', 'BPMN', 'normalization', 'state diagrams')",
+                        },
+                        num_questions: {
+                            type: "number",
+                            description: "Number of questions to generate. Defaults to 5.",
+                        },
+                    },
+                    required: ["topic"],
+                },
+            },
         ],
     }));
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
@@ -146,6 +174,55 @@ export function registerToolHandlers(server) {
                 ],
             };
         }
+        if (name === "quiz") {
+            const topic = args.topic;
+            const numQuestions = args.num_questions || 5;
+            if (!topic) {
+                return {
+                    content: [{ type: "text", text: "Error: topic parameter is required" }],
+                };
+            }
+            await ensureTextCache();
+            // Gather relevant material for the topic
+            const relevantContent = [];
+            for (const [, { file, text }] of textCache) {
+                const matches = searchInText(text, topic);
+                if (matches.length > 0) {
+                    // Include surrounding context (5 lines around each match)
+                    const lines = text.split("\n");
+                    const snippets = [];
+                    for (const match of matches.slice(0, 10)) {
+                        const start = Math.max(0, match.lineNumber - 6);
+                        const end = Math.min(lines.length, match.lineNumber + 4);
+                        snippets.push(lines.slice(start, end).join("\n"));
+                    }
+                    relevantContent.push(`--- ${file.name} ---\n${snippets.join("\n...\n")}`);
+                }
+            }
+            if (relevantContent.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `No course material found on "${topic}". Try a different topic or check available materials with list_materials.`,
+                        },
+                    ],
+                };
+            }
+            const materialText = relevantContent.join("\n\n");
+            // Truncate if too large
+            const truncated = materialText.length > 15000
+                ? materialText.substring(0, 15000) + "\n...[truncated]"
+                : materialText;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `QUIZ REQUEST: Generate ${numQuestions} practice questions on "${topic}" based ONLY on the following course material. Mix question types: multiple choice, true/false, and short answer. For each question, provide the answer and a brief explanation referencing the source material. Write questions and answers in Hebrew.\n\n=== COURSE MATERIAL ===\n${truncated}`,
+                    },
+                ],
+            };
+        }
         throw new Error(`Unknown tool: ${name}`);
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sad-mcp",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "MCP server for Software Analysis and Design course materials at BGU",
   "type": "module",
   "bin": {