sad-mcp 0.1.6 → 0.1.8

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.6" }, {
+    const server = new Server({ name: "sad-mcp", version: "0.1.7" }, {
         capabilities: {
             tools: {},
             prompts: {},

package/dist/tools.js

@@ -46,7 +46,7 @@ export function registerToolHandlers(server) {
         tools: [
             {
                 name: "search_materials",
-                description: "Search across all course materials (lecture transcripts, presentations, exams) for relevant content. Use this when a student asks about a specific topic.",
+                description: "Search across all course materials for a topic. Returns a SHORT summary list of matching files (name, category, match count). To read the actual content, use get_material on the most relevant file(s) from the results.",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -58,6 +58,20 @@ export function registerToolHandlers(server) {
                     required: ["query"],
                 },
             },
+            {
+                name: "get_material",
+                description: "Get the full text content of a specific course material file. Use this AFTER search_materials to read the content of a relevant file.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        name: {
+                            type: "string",
+                            description: "The file name (or partial name) to retrieve. Matched against file names from search_materials or list_materials results.",
+                        },
+                    },
+                    required: ["name"],
+                },
+            },
             {
                 name: "list_materials",
                 description: "List all available course materials, optionally filtered by category.",
@@ -72,6 +86,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) => {
@@ -91,12 +123,14 @@ export function registerToolHandlers(server) {
                 if (matches.length > 0) {
                     results.push({
                         fileName: file.name,
-                        path: file.path,
                         category: categorizeFile(file),
-                        matches: matches.slice(0, 5), // Top 5 matches per file
+                        matchCount: matches.length,
+                        preview: matches[0].line.trim().substring(0, 120),
                     });
                 }
             }
+            // Sort by match count descending (most relevant first)
+            results.sort((a, b) => b.matchCount - a.matchCount);
             if (results.length === 0) {
                 return {
                     content: [
@@ -108,18 +142,53 @@ export function registerToolHandlers(server) {
                 };
             }
             const formatted = results
-                .map((r) => {
-                const matchLines = r.matches
-                    .map((m) => `  Line ${m.lineNumber}: ${m.line.substring(0, 200)}`)
-                    .join("\n");
-                return `📄 ${r.fileName} [${r.category}]\n   Path: ${r.path}\n${matchLines}`;
-            })
-                .join("\n\n");
+                .map((r) => `- ${r.fileName} [${r.category}] (${r.matchCount} matches) — "${r.preview}"`)
+                .join("\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Found "${query}" in ${results.length} file(s). Use get_material to read the most relevant one(s):\n\n${formatted}`,
+                    },
+                ],
+            };
+        }
+        if (name === "get_material") {
+            const queryName = args.name;
+            if (!queryName) {
+                return {
+                    content: [{ type: "text", text: "Error: name parameter is required" }],
+                };
+            }
+            await ensureTextCache();
+            const queryLower = queryName.toLowerCase();
+            let bestMatch = null;
+            for (const [, entry] of textCache) {
+                if (entry.file.name.toLowerCase().includes(queryLower)) {
+                    bestMatch = entry;
+                    break;
+                }
+            }
+            if (!bestMatch) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `No file found matching "${queryName}". Use search_materials or list_materials to find available files.`,
+                        },
+                    ],
+                };
+            }
+            // Truncate very large files
+            const maxLen = 30000;
+            const text = bestMatch.text.length > maxLen
+                ? bestMatch.text.substring(0, maxLen) + "\n...[truncated]"
+                : bestMatch.text;
             return {
                 content: [
                     {
                         type: "text",
-                        text: `Found matches in ${results.length} file(s) for "${query}":\n\n${formatted}`,
+                        text: `📄 ${bestMatch.file.name} [${categorizeFile(bestMatch.file)}]\n\n${text}`,
                     },
                 ],
             };
@@ -156,6 +225,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.6",
+  "version": "0.1.8",
   "description": "MCP server for Software Analysis and Design course materials at BGU",
   "type": "module",
   "bin": {