@charlie.act7/canvas-mcp-server 1.2.0 → 1.2.2

package/dist/tools/question-bank-tools.js

@@ -0,0 +1,238 @@
+import { resolveCourseId } from "../common/helpers.js";
+import { z } from "zod";
+export const questionBankTools = [
+    {
+        name: "canvas_list_question_banks",
+        tool: {
+            name: "canvas_list_question_banks",
+            description: "List question banks for a specific course",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    course_id: {
+                        anyOf: [{ type: "number" }, { type: "string" }],
+                        description: "The ID or name of the course"
+                    }
+                },
+                required: ["course_id"]
+            }
+        },
+        handler: async (client, args) => {
+            const input = z.object({ course_id: z.union([z.number(), z.string()]) }).parse(args);
+            const courseId = await resolveCourseId(client, input.course_id);
+            const banks = await client.listQuestionBanks(courseId);
+            return {
+                content: [{ type: "text", text: JSON.stringify(banks, null, 2) }]
+            };
+        }
+    },
+    {
+        name: "canvas_create_question_bank",
+        tool: {
+            name: "canvas_create_question_bank",
+            description: "Create a new question bank in a course",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    course_id: {
+                        anyOf: [{ type: "number" }, { type: "string" }],
+                        description: "The ID or name of the course"
+                    },
+                    title: {
+                        type: "string",
+                        description: "Title for the question bank"
+                    }
+                },
+                required: ["course_id", "title"]
+            }
+        },
+        handler: async (client, args) => {
+            const input = z.object({
+                course_id: z.union([z.number(), z.string()]),
+                title: z.string().min(1)
+            }).parse(args);
+            const courseId = await resolveCourseId(client, input.course_id);
+            const bank = await client.createQuestionBank(courseId, input.title);
+            return {
+                content: [{ type: "text", text: JSON.stringify(bank, null, 2) }]
+            };
+        }
+    },
+    {
+        name: "canvas_create_assessment_question",
+        tool: {
+            name: "canvas_create_assessment_question",
+            description: "Create a question in a question bank. Supports types: multiple_choice_question, true_false_question, essay_question, short_answer_question, fill_in_multiple_blanks_question, multiple_answers_question, matching_question, numerical_question.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    course_id: {
+                        anyOf: [{ type: "number" }, { type: "string" }],
+                        description: "The ID or name of the course"
+                    },
+                    bank_id: {
+                        type: "number",
+                        description: "The question bank ID"
+                    },
+                    name: {
+                        type: "string",
+                        description: "Short name/title for the question"
+                    },
+                    question_type: {
+                        type: "string",
+                        description: "Question type (e.g. multiple_choice_question, true_false_question, essay_question, short_answer_question)"
+                    },
+                    question_text: {
+                        type: "string",
+                        description: "The question text (HTML supported)"
+                    },
+                    points_possible: {
+                        type: "number",
+                        description: "Point value for the question"
+                    },
+                    answers: {
+                        type: "array",
+                        description: "Array of answer objects. For multiple_choice: weight=100 for correct, weight=0 for incorrect. For true_false: text='True'/'False'.",
+                        items: {
+                            type: "object",
+                            properties: {
+                                text: { type: "string", description: "Answer text" },
+                                weight: { type: "number", description: "100 for correct, 0 for incorrect" },
+                                comments: { type: "string", description: "Optional feedback comment" }
+                            },
+                            required: ["text", "weight"]
+                        }
+                    }
+                },
+                required: ["course_id", "bank_id", "name", "question_type", "question_text", "points_possible"]
+            }
+        },
+        handler: async (client, args) => {
+            const answerSchema = z.object({
+                text: z.string(),
+                weight: z.number(),
+                comments: z.string().optional()
+            });
+            const input = z.object({
+                course_id: z.union([z.number(), z.string()]),
+                bank_id: z.coerce.number(),
+                name: z.string().min(1),
+                question_type: z.string().min(1),
+                question_text: z.string().min(1),
+                points_possible: z.coerce.number(),
+                answers: z.array(answerSchema).optional()
+            }).parse(args);
+            const courseId = await resolveCourseId(client, input.course_id);
+            const question = await client.createAssessmentQuestion(courseId, input.bank_id, {
+                name: input.name,
+                question_type: input.question_type,
+                question_text: input.question_text,
+                points_possible: input.points_possible,
+                answers: input.answers
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(question, null, 2) }]
+            };
+        }
+    },
+    {
+        name: "canvas_move_question_bank_questions",
+        tool: {
+            name: "canvas_move_question_bank_questions",
+            description: "Move questions from one question bank to another. If question_ids is omitted, all questions are moved.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    course_id: {
+                        anyOf: [{ type: "number" }, { type: "string" }],
+                        description: "The ID or name of the course"
+                    },
+                    source_bank_id: {
+                        type: "number",
+                        description: "Source question bank ID"
+                    },
+                    dest_bank_id: {
+                        type: "number",
+                        description: "Destination question bank ID"
+                    },
+                    question_ids: {
+                        type: "array",
+                        items: { type: "number" },
+                        description: "Optional list of specific question IDs to move. If omitted, all questions are moved."
+                    }
+                },
+                required: ["course_id", "source_bank_id", "dest_bank_id"]
+            }
+        },
+        handler: async (client, args) => {
+            const input = z.object({
+                course_id: z.union([z.number(), z.string()]),
+                source_bank_id: z.coerce.number(),
+                dest_bank_id: z.coerce.number(),
+                question_ids: z.array(z.coerce.number()).optional()
+            }).parse(args);
+            const courseId = await resolveCourseId(client, input.course_id);
+            const result = await client.moveQuestionBankQuestions(courseId, input.source_bank_id, input.dest_bank_id, input.question_ids);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+    },
+    {
+        name: "canvas_create_quiz_group",
+        tool: {
+            name: "canvas_create_quiz_group",
+            description: "Create a quiz group linked to a question bank. The group randomly picks questions from the bank when students take the quiz.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    course_id: {
+                        anyOf: [{ type: "number" }, { type: "string" }],
+                        description: "The ID or name of the course"
+                    },
+                    quiz_id: {
+                        type: "number",
+                        description: "The quiz ID"
+                    },
+                    name: {
+                        type: "string",
+                        description: "Name for the quiz group"
+                    },
+                    pick_count: {
+                        type: "number",
+                        description: "Number of questions to randomly pick from the bank"
+                    },
+                    question_points: {
+                        type: "number",
+                        description: "Points per question in this group"
+                    },
+                    assessment_question_bank_id: {
+                        type: "number",
+                        description: "The question bank ID to link to this group"
+                    }
+                },
+                required: ["course_id", "quiz_id", "name", "pick_count", "question_points"]
+            }
+        },
+        handler: async (client, args) => {
+            const input = z.object({
+                course_id: z.union([z.number(), z.string()]),
+                quiz_id: z.coerce.number(),
+                name: z.string().min(1),
+                pick_count: z.coerce.number().min(1),
+                question_points: z.coerce.number().min(0),
+                assessment_question_bank_id: z.coerce.number().optional()
+            }).parse(args);
+            const courseId = await resolveCourseId(client, input.course_id);
+            const group = await client.createQuizGroup(courseId, input.quiz_id, {
+                name: input.name,
+                pick_count: input.pick_count,
+                question_points: input.question_points,
+                assessment_question_bank_id: input.assessment_question_bank_id
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(group, null, 2) }]
+            };
+        }
+    }
+];

package/dist/tools/quiz-tools.js

@@ -196,18 +196,18 @@ export const quizTools = [
         name: "canvas_create_quiz_question",
         tool: {
             name: "canvas_create_quiz_question",
-            description: `Create a new question in a quiz. Supports all 12 Canvas question types:
-- multiple_choice_question: answers with answer_text + answer_weight (100=correct, 0=wrong)
-- true_false_question: two answers ("True"/"False") with answer_weight
-- short_answer_question: one or more correct answer_text values, all with answer_weight 100
-- fill_in_multiple_blanks_question: answers with blank_id + answer_text + answer_weight 100
-- multiple_answers_question: checkboxes; correct answers get answer_weight 100, wrong get 0
-- multiple_dropdowns_question: answers with blank_id + answer_text + answer_weight
-- matching_question: answers with answer_match_left + answer_match_right; add distractors via matching_answer_incorrect_matches on any one answer
-- numerical_question: answers with numerical_answer_type (exact_answer: exact+margin; range_answer: start+end; precision_answer: approximate+precision)
-- calculated_question: answers with variables and formulas (advanced)
-- essay_question: no answers needed
-- file_upload_question: no answers needed
+            description: `Create a new question in a quiz. Supports all 12 Canvas question types:
+- multiple_choice_question: answers with answer_text + answer_weight (100=correct, 0=wrong)
+- true_false_question: two answers ("True"/"False") with answer_weight
+- short_answer_question: one or more correct answer_text values, all with answer_weight 100
+- fill_in_multiple_blanks_question: answers with blank_id + answer_text + answer_weight 100
+- multiple_answers_question: checkboxes; correct answers get answer_weight 100, wrong get 0
+- multiple_dropdowns_question: answers with blank_id + answer_text + answer_weight
+- matching_question: answers with answer_match_left + answer_match_right; add distractors via matching_answer_incorrect_matches on any one answer
+- numerical_question: answers with numerical_answer_type (exact_answer: exact+margin; range_answer: start+end; precision_answer: approximate+precision)
+- calculated_question: answers with variables and formulas (advanced)
+- essay_question: no answers needed
+- file_upload_question: no answers needed
 - text_only_question: no answers needed, just displays text`,
             inputSchema: {
                 type: "object",
@@ -437,6 +437,78 @@ export const quizTools = [
             return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
         }
     },
+    {
+        name: "canvas_get_quiz_submissions",
+        tool: {
+            name: "canvas_get_quiz_submissions",
+            description: "Get all submissions for a quiz, including user info. Useful to see who has responded.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    course_id: { anyOf: [{ type: "number" }, { type: "string" }], description: "The ID or name of the course" },
+                    quiz_id: { type: "number", description: "The quiz ID" }
+                },
+                required: ["course_id", "quiz_id"]
+            }
+        },
+        handler: async (client, args) => {
+            const input = z.object({
+                course_id: z.union([z.number(), z.string()]),
+                quiz_id: z.number()
+            }).parse(args);
+            const courseId = await resolveCourseId(client, input.course_id);
+            const submissions = await client.getQuizSubmissions(courseId, input.quiz_id);
+            return { content: [{ type: "text", text: JSON.stringify(submissions, null, 2) }] };
+        }
+    },
+    {
+        name: "canvas_check_quiz_pending",
+        tool: {
+            name: "canvas_check_quiz_pending",
+            description: "Check which enrolled students have NOT submitted a quiz. Returns a list of pending students with their name and email. Excludes test accounts.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    course_id: { anyOf: [{ type: "number" }, { type: "string" }], description: "The ID or name of the course" },
+                    quiz_id: { type: "number", description: "The quiz ID" }
+                },
+                required: ["course_id", "quiz_id"]
+            }
+        },
+        handler: async (client, args) => {
+            const input = z.object({
+                course_id: z.union([z.number(), z.string()]),
+                quiz_id: z.number()
+            }).parse(args);
+            const courseId = await resolveCourseId(client, input.course_id);
+            const result = await client.checkQuizPending(courseId, input.quiz_id);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+    },
+    {
+        name: "canvas_delete_quiz",
+        tool: {
+            name: "canvas_delete_quiz",
+            description: "Permanently delete a classic quiz from a course. This cannot be undone.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    course_id: { anyOf: [{ type: "number" }, { type: "string" }], description: "The ID or name of the course" },
+                    quiz_id: { type: "number", description: "The quiz ID to delete" }
+                },
+                required: ["course_id", "quiz_id"]
+            }
+        },
+        handler: async (client, args) => {
+            const input = z.object({
+                course_id: z.union([z.number(), z.string()]),
+                quiz_id: z.number()
+            }).parse(args);
+            const courseId = await resolveCourseId(client, input.course_id);
+            const result = await client.deleteQuiz(courseId, input.quiz_id);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+    },
     {
         name: "canvas_update_quiz",
         tool: {

package/package.json

@@ -1,70 +1,76 @@
-{
-    "name": "@charlie.act7/canvas-mcp-server",
-    "publishConfig": {
-        "access": "public"
-    },
-    "version": "1.2.0",
-    "description": "MCP Server for Canvas LMS - Use AI to interact with your courses, assignments, and grades.",
-    "main": "dist/index.js",
-    "bin": {
-        "canvas-mcp": "dist/index.js"
-    },
-    "type": "module",
-    "files": [
-        "dist/index.js",
-        "dist/http-server.js",
-        "dist/common",
-        "dist/prompts",
-        "dist/resources",
-        "dist/services",
-        "dist/tools",
-        "README.md",
-        "llms-install.md",
-        ".claude-plugin",
-        ".mcp.json"
-    ],
-    "scripts": {
-        "build": "tsc",
-        "start": "node dist/index.js",
-        "start:http": "node dist/index.js serve-http",
-        "dev": "tsc --watch",
-        "chat": "tsx src/ollama_bridge.ts",
-        "prepublishOnly": "npm run build"
-    },
-    "keywords": [
-        "mcp",
-        "canvas",
-        "lms",
-        "ai",
-        "agent",
-        "server"
-    ],
-    "author": "Charlie Cárdenas Toledo",
-    "license": "MIT",
-    "dependencies": {
-        "@fastify/swagger": "^9.5.2",
-        "@fastify/swagger-ui": "^5.2.3",
-        "@google/genai": "^2.8.0",
-        "@modelcontextprotocol/sdk": "^1.25.3",
-        "axios": "^1.6.0",
-        "chalk": "^5.3.0",
-        "commander": "^11.1.0",
-        "conf": "^12.0.0",
-        "dotenv": "^16.3.1",
-        "fastify": "^5.6.1",
-        "form-data": "^4.0.5",
-        "inquirer": "^9.2.12",
-        "ollama": "^0.6.3",
-        "zod": "^3.22.4"
-    },
-    "devDependencies": {
-        "@types/inquirer": "^9.0.7",
-        "@types/node": "^20.10.0",
-        "nodemon": "^3.1.11",
-        "tsx": "^4.21.0",
-        "typescript": "^5.3.0"
-    },
-    "engines": {
-        "node": ">=18.0.0"
-    }
-}
+{
+  "name": "@charlie.act7/canvas-mcp-server",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CharlieCardenasToledo/mcp-canvas-server.git"
+  },
+  "homepage": "https://github.com/CharlieCardenasToledo/mcp-canvas-server#readme",
+  "bugs": {
+    "url": "https://github.com/CharlieCardenasToledo/mcp-canvas-server/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "1.2.2",
+  "description": "MCP Server for Canvas LMS - Use AI to interact with your courses, assignments, and grades.",
+  "main": "dist/index.js",
+  "bin": {
+    "canvas-mcp": "dist/index.js"
+  },
+  "type": "module",
+  "files": [
+    "dist/index.js",
+    "dist/http-server.js",
+    "dist/common",
+    "dist/prompts",
+    "dist/resources",
+    "dist/services",
+    "dist/tools",
+    "README.md",
+    "llms-install.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "start:http": "node dist/index.js serve-http",
+    "dev": "tsc --watch",
+    "chat": "tsx src/ollama_bridge.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "canvas",
+    "lms",
+    "ai",
+    "agent",
+    "server"
+  ],
+  "author": "Charlie Cárdenas Toledo",
+  "license": "MIT",
+  "dependencies": {
+    "@fastify/swagger": "^9.5.2",
+    "@fastify/swagger-ui": "^5.2.3",
+    "@google/genai": "^2.8.0",
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "axios": "^1.6.0",
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "conf": "^12.0.0",
+    "dotenv": "^16.3.1",
+    "fastify": "^5.6.1",
+    "form-data": "^4.0.5",
+    "inquirer": "^9.2.12",
+    "ollama": "^0.6.3",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.10.0",
+    "nodemon": "^3.1.11",
+    "tsx": "^4.21.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/.claude-plugin/plugin.json

@@ -1,11 +0,0 @@
-{
-  "name": "canvas-lms",
-  "description": "Canvas LMS integration for teachers. Manage courses, assignments, grades, quizzes, students, modules, and more — directly from Claude Code.",
-  "version": "1.1.0",
-  "author": {
-    "name": "CharlieCardenasToledo"
-  },
-  "homepage": "https://github.com/CharlieCardenasToledo/canvas-mcp-server",
-  "repository": "https://github.com/CharlieCardenasToledo/canvas-mcp-server",
-  "license": "MIT"
-}

package/.mcp.json

@@ -1,12 +0,0 @@
-{
-  "mcpServers": {
-    "canvas": {
-      "command": "npx",
-      "args": ["-y", "@charlie.act7/canvas-mcp-server"],
-      "env": {
-        "CANVAS_API_TOKEN": "${CANVAS_API_TOKEN}",
-        "CANVAS_API_DOMAIN": "${CANVAS_API_DOMAIN}"
-      }
-    }
-  }
-}