@mtgibbs/canvas-lms-mcp 0.1.0

package/esm/src/mcp/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Type definitions for MCP tools and prompts
+ */
+import type { z } from "zod";
+/**
+ * Tool annotations for MCP protocol
+ * These hints describe tool behavior for safety and UI purposes
+ */
+export interface ToolAnnotations {
+    /** If true, the tool does not modify its environment (read-only operation) */
+    readOnlyHint?: boolean;
+    /** If true, the tool may perform destructive updates */
+    destructiveHint?: boolean;
+    /** If true, repeated calls with same args have no additional effect */
+    idempotentHint?: boolean;
+    /** If true, tool interacts with external entities */
+    openWorldHint?: boolean;
+}
+/**
+ * Tool definition that can be registered with the MCP server
+ *
+ * Use the generic version for type-safe tool definitions.
+ * The non-generic version is used for collections of tools with different schemas.
+ */
+export interface ToolDefinition<T extends z.ZodRawShape = z.ZodRawShape> {
+    name: string;
+    description: string;
+    schema: T;
+    annotations?: ToolAnnotations;
+    handler: (args: z.infer<z.ZodObject<T>>) => Promise<ToolResponse>;
+}
+export type AnyToolDefinition = ToolDefinition<any>;
+/**
+ * Standard tool response format
+ */
+export interface ToolResponse {
+    content: Array<{
+        type: "text" | "image" | "resource";
+        text?: string;
+        data?: string;
+        mimeType?: string;
+        uri?: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Prompt argument definition
+ */
+export interface PromptArgument {
+    name: string;
+    description?: string;
+    required?: boolean;
+}
+/**
+ * Prompt definition that can be registered with the MCP server
+ */
+export interface PromptDefinition {
+    name: string;
+    description: string;
+    arguments: PromptArgument[];
+    handler: (args: Record<string, string | undefined>) => PromptResponse;
+}
+/**
+ * Standard prompt response format
+ */
+export interface PromptResponse {
+    messages: Array<{
+        role: "user" | "assistant";
+        content: {
+            type: "text";
+            text: string;
+        };
+    }>;
+}
+/**
+ * Helper to create a JSON text response (most common pattern)
+ */
+export declare function jsonResponse(data: unknown): ToolResponse;
+/**
+ * Helper to create an error response
+ */
+export declare function errorResponse(message: string): ToolResponse;
+//# sourceMappingURL=types.d.ts.map

package/esm/src/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/mcp/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wDAAwD;IACxD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qDAAqD;IACrD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC;IACV,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CACnE;AAGD,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;QACpC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KAAK,cAAc,CAAC;CACvE;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAC3B,OAAO,EAAE;YACP,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,CAIxD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAK3D"}

package/esm/src/mcp/types.js

@@ -0,0 +1,20 @@
+/**
+ * Type definitions for MCP tools and prompts
+ */
+/**
+ * Helper to create a JSON text response (most common pattern)
+ */
+export function jsonResponse(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+/**
+ * Helper to create an error response
+ */
+export function errorResponse(message) {
+    return {
+        content: [{ type: "text", text: message }],
+        isError: true,
+    };
+}

package/esm/src/types/canvas.d.ts

@@ -0,0 +1,288 @@
+/**
+ * Canvas LMS API Type Definitions
+ * Based on: https://canvas.instructure.com/doc/api/
+ */
+/** Course object from Canvas API */
+export interface Course {
+    id: number;
+    name: string;
+    course_code: string;
+    workflow_state: "unpublished" | "available" | "completed" | "deleted";
+    account_id: number;
+    start_at: string | null;
+    end_at: string | null;
+    enrollments?: Enrollment[];
+    total_students?: number;
+    term?: Term;
+    time_zone?: string;
+}
+/** Term/semester information */
+export interface Term {
+    id: number;
+    name: string;
+    start_at: string | null;
+    end_at: string | null;
+}
+/** Enrollment object with grade information */
+export interface Enrollment {
+    id: number;
+    course_id: number;
+    user_id: number;
+    type: EnrollmentType;
+    enrollment_state: "active" | "invited" | "inactive" | "completed" | "deleted";
+    role: string;
+    grades?: Grades;
+    user?: User;
+    observed_user?: User;
+}
+export type EnrollmentType = "StudentEnrollment" | "TeacherEnrollment" | "TaEnrollment" | "ObserverEnrollment" | "DesignerEnrollment";
+/** Grade information within an enrollment */
+export interface Grades {
+    html_url: string;
+    current_grade: string | null;
+    final_grade: string | null;
+    current_score: number | null;
+    final_score: number | null;
+    current_points?: number;
+    unposted_current_grade?: string | null;
+    unposted_final_grade?: string | null;
+    unposted_current_score?: number | null;
+    unposted_final_score?: number | null;
+}
+/** User object */
+export interface User {
+    id: number;
+    name: string;
+    sortable_name: string;
+    short_name: string;
+    login_id?: string;
+    email?: string;
+    avatar_url?: string;
+}
+/** Assignment object */
+export interface Assignment {
+    id: number;
+    name: string;
+    description: string | null;
+    due_at: string | null;
+    unlock_at: string | null;
+    lock_at: string | null;
+    points_possible: number | null;
+    course_id: number;
+    submission_types: SubmissionType[];
+    html_url: string;
+    has_submitted_submissions: boolean;
+    published: boolean;
+    workflow_state: "published" | "unpublished" | "deleted";
+    assignment_group_id: number;
+    position: number;
+    grading_type: GradingType;
+    submission?: Submission;
+    submissions_download_url?: string;
+    /** External tool URL if applicable */
+    external_tool_tag_attributes?: {
+        url: string;
+        new_tab: boolean;
+        resource_link_id: string;
+    };
+    /** Attached files/materials */
+    attachments?: Attachment[];
+}
+export type SubmissionType = "online_text_entry" | "online_url" | "online_upload" | "media_recording" | "student_annotation" | "external_tool" | "on_paper" | "none";
+export type GradingType = "pass_fail" | "percent" | "letter_grade" | "gpa_scale" | "points" | "not_graded";
+/** File attachment */
+export interface Attachment {
+    id: number;
+    uuid: string;
+    filename: string;
+    display_name: string;
+    content_type: string;
+    url: string;
+    size: number;
+    created_at: string;
+    updated_at: string;
+}
+/** Submission object */
+export interface Submission {
+    id: number;
+    assignment_id: number;
+    user_id: number;
+    submission_type: SubmissionType | null;
+    submitted_at: string | null;
+    grade: string | null;
+    score: number | null;
+    entered_grade: string | null;
+    entered_score: number | null;
+    late: boolean;
+    missing: boolean;
+    excused: boolean | null;
+    late_policy_status: "late" | "missing" | "extended" | "none" | null;
+    points_deducted: number | null;
+    grading_period_id: number | null;
+    workflow_state: "submitted" | "unsubmitted" | "graded" | "pending_review";
+    grade_matches_current_submission: boolean;
+    posted_at: string | null;
+    assignment?: Assignment;
+    user?: User;
+    course?: Course;
+    html_url?: string;
+    preview_url?: string;
+    attachments?: Attachment[];
+    submission_comments?: SubmissionComment[];
+}
+/** Comment on a submission */
+export interface SubmissionComment {
+    id: number;
+    author_id: number;
+    author_name: string;
+    comment: string;
+    created_at: string;
+    author?: User;
+}
+/** Missing submission (from /users/:id/missing_submissions) */
+export interface MissingSubmission {
+    id: number;
+    name: string;
+    description: string | null;
+    due_at: string | null;
+    unlock_at: string | null;
+    lock_at: string | null;
+    points_possible: number | null;
+    course_id: number;
+    html_url: string;
+    submission_types: SubmissionType[];
+    course?: Course;
+    planner_override?: PlannerOverride;
+}
+/** Planner override for managing todo items */
+export interface PlannerOverride {
+    id: number;
+    plannable_type: string;
+    plannable_id: number;
+    user_id: number;
+    marked_complete: boolean;
+    dismissed: boolean;
+}
+/** Upcoming event (assignment or calendar event) */
+export interface UpcomingEvent {
+    id: string;
+    title: string;
+    start_at: string;
+    end_at?: string;
+    type: "event" | "assignment";
+    context_code: string;
+    html_url: string;
+    assignment?: Assignment;
+}
+/** Planner item (from /api/v1/planner/items) */
+export interface PlannerItem {
+    context_type: "Course" | "Group" | "User";
+    course_id?: number;
+    group_id?: number;
+    user_id?: number;
+    plannable_id: number;
+    plannable_type: "assignment" | "quiz" | "discussion_topic" | "wiki_page" | "planner_note" | "calendar_event" | "announcement";
+    planner_override: PlannerOverride | null;
+    new_activity: boolean;
+    submissions?: PlannerSubmissionStatus;
+    plannable_date: string;
+    plannable: {
+        id: number;
+        title: string;
+        created_at: string;
+        updated_at: string;
+        points_possible: number | null;
+        due_at: string | null;
+    };
+    html_url: string;
+    context_name: string;
+    context_image?: string | null;
+}
+/** Submission status in planner items */
+export interface PlannerSubmissionStatus {
+    submitted: boolean;
+    excused: boolean;
+    graded: boolean;
+    posted_at: string | null;
+    late: boolean;
+    missing: boolean;
+    needs_grading: boolean;
+    has_feedback: boolean;
+    redo_request: boolean;
+}
+/** Canvas API pagination info parsed from Link header */
+export interface PaginationLinks {
+    current?: string;
+    next?: string;
+    prev?: string;
+    first?: string;
+    last?: string;
+}
+/** Generic API error response */
+export interface ApiError {
+    status: string;
+    message: string;
+    errors?: Array<{
+        message: string;
+    }>;
+}
+/** Options for listing courses */
+export interface ListCoursesOptions {
+    enrollment_type?: EnrollmentType;
+    enrollment_state?: "active" | "invited" | "completed";
+    include?: Array<"total_students" | "enrollments" | "term" | "course_image">;
+    state?: Array<"unpublished" | "available" | "completed" | "deleted">;
+}
+/** Options for listing assignments */
+export interface ListAssignmentsOptions {
+    course_id: number;
+    bucket?: "past" | "overdue" | "undated" | "ungraded" | "unsubmitted" | "upcoming" | "future";
+    order_by?: "position" | "name" | "due_at";
+    include?: Array<"submission" | "assignment_visibility" | "all_dates" | "overrides">;
+    search_term?: string;
+}
+/** Options for listing submissions */
+export interface ListSubmissionsOptions {
+    course_id: number;
+    assignment_ids?: number[];
+    student_ids?: number[] | "all";
+    grouped?: boolean;
+    include?: Array<"submission_history" | "submission_comments" | "rubric_assessment" | "assignment" | "user">;
+    workflow_state?: "submitted" | "unsubmitted" | "graded" | "pending_review";
+}
+/** Options for missing submissions */
+export interface MissingSubmissionsOptions {
+    user_id?: string | number;
+    observed_user_id?: string | number;
+    course_ids?: number[];
+    include?: Array<"planner_overrides" | "course">;
+    filter?: Array<"submittable" | "current_grading_period">;
+}
+/** CLI output format type */
+export type OutputFormat = "json" | "table";
+/** Course with grade summary (for display) */
+export interface CourseWithGrade {
+    id: number;
+    name: string;
+    course_code: string;
+    current_grade: string | null;
+    current_score: number | null;
+    final_grade: string | null;
+    final_score: number | null;
+}
+/** Assignment with submission status (for display) */
+export interface AssignmentWithStatus {
+    id: number;
+    course_id: number;
+    course_name?: string;
+    name: string;
+    due_at: string | null;
+    points_possible: number | null;
+    submitted: boolean;
+    grade: string | null;
+    score: number | null;
+    missing: boolean;
+    late: boolean;
+    html_url: string;
+}
+//# sourceMappingURL=canvas.d.ts.map

package/esm/src/types/canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../../src/src/types/canvas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oCAAoC;AACpC,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,gCAAgC;AAChC,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;IACrB,gBAAgB,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,aAAa,CAAC,EAAE,IAAI,CAAC;CACtB;AAED,MAAM,MAAM,cAAc,GACtB,mBAAmB,GACnB,mBAAmB,GACnB,cAAc,GACd,oBAAoB,GACpB,oBAAoB,CAAC;AAEzB,6CAA6C;AAC7C,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,kBAAkB;AAClB,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAwB;AACxB,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,cAAc,EAAE,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB,EAAE,OAAO,CAAC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;IACxD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,sCAAsC;IACtC,4BAA4B,CAAC,EAAE;QAC7B,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,OAAO,CAAC;QACjB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,+BAA+B;IAC/B,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B;AAED,MAAM,MAAM,cAAc,GACtB,mBAAmB,GACnB,YAAY,GACZ,eAAe,GACf,iBAAiB,GACjB,oBAAoB,GACpB,eAAe,GACf,UAAU,GACV,MAAM,CAAC;AAEX,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,SAAS,GACT,cAAc,GACd,WAAW,GACX,QAAQ,GACR,YAAY,CAAC;AAEjB,sBAAsB;AACtB,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAwB;AACxB,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,cAAc,GAAG,IAAI,CAAC;IACvC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,kBAAkB,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC;IACpE,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,EAAE,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,gBAAgB,CAAC;IAC1E,gCAAgC,EAAE,OAAO,CAAC;IAC1C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,mBAAmB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC3C;AAED,8BAA8B;AAC9B,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,IAAI,CAAC;CACf;AAED,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,cAAc,EAAE,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,eAAe,CAAC;CACpC;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,GAAG,YAAY,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,YAAY,GAAG,MAAM,GAAG,kBAAkB,GAAG,WAAW,GAAG,cAAc,GAAG,gBAAgB,GAAG,cAAc,CAAC;IAC9H,gBAAgB,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE;QACT,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,yCAAyC;AACzC,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iCAAiC;AACjC,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrC;AAED,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,gBAAgB,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IACtD,OAAO,CAAC,EAAE,KAAK,CAAC,gBAAgB,GAAG,aAAa,GAAG,MAAM,GAAG,cAAc,CAAC,CAAC;IAC5E,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC,CAAC;CACtE;AAED,sCAAsC;AACtC,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC7F,QAAQ,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC1C,OAAO,CAAC,EAAE,KAAK,CAAC,YAAY,GAAG,uBAAuB,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,sCAAsC;AACtC,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,KAAK,CACb,oBAAoB,GAAG,qBAAqB,GAAG,mBAAmB,GAAG,YAAY,GAAG,MAAM,CAC3F,CAAC;IACF,cAAc,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,gBAAgB,CAAC;CAC5E;AAED,sCAAsC;AACtC,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,KAAK,CAAC,mBAAmB,GAAG,QAAQ,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,KAAK,CAAC,aAAa,GAAG,wBAAwB,CAAC,CAAC;CAC1D;AAED,6BAA6B;AAC7B,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5C,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,sDAAsD;AACtD,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/esm/src/types/canvas.js

@@ -0,0 +1,5 @@
+/**
+ * Canvas LMS API Type Definitions
+ * Based on: https://canvas.instructure.com/doc/api/
+ */
+export {};

package/esm/src/utils/config.d.ts

@@ -0,0 +1,19 @@
+export interface Config {
+    apiToken: string;
+    baseUrl: string;
+    studentId: string;
+}
+/**
+ * Load configuration from environment variables
+ * Tries to load from .env file first, then falls back to process env
+ */
+export declare function loadConfig(): Promise<Config>;
+/**
+ * Get config synchronously (must call loadConfig first)
+ */
+export declare function getConfig(): Config;
+/**
+ * Clear cached config (useful for testing)
+ */
+export declare function clearConfigCache(): void;
+//# sourceMappingURL=config.d.ts.map

package/esm/src/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/src/utils/config.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;GAGG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAwClD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/esm/src/utils/config.js

@@ -0,0 +1,54 @@
+/**
+ * Configuration loader for Canvas CLI
+ * Loads settings from environment variables
+ *
+ * Note: When built for npm with dnt, Deno APIs are shimmed to Node.js equivalents.
+ * The dotenv loading for Node.js is handled by the bin wrapper.
+ */
+import * as dntShim from "../../_dnt.shims.js";
+// dotenv is loaded via cli.js wrapper
+let cachedConfig = null;
+/**
+ * Load configuration from environment variables
+ * Tries to load from .env file first, then falls back to process env
+ */
+export async function loadConfig() {
+    if (cachedConfig) {
+        return cachedConfig;
+    }
+    // dotenv is loaded via cli.js wrapper (dotenv/config)
+    const apiToken = dntShim.Deno.env.get("CANVAS_API_TOKEN");
+    const baseUrl = dntShim.Deno.env.get("CANVAS_BASE_URL");
+    const studentId = dntShim.Deno.env.get("CANVAS_STUDENT_ID") || "self";
+    if (!apiToken) {
+        throw new Error("CANVAS_API_TOKEN is required. Set it in .env or as an environment variable.\n" +
+            "Generate a token at: Canvas > Account > Settings > Approved Integrations > New Access Token");
+    }
+    if (!baseUrl) {
+        throw new Error("CANVAS_BASE_URL is required. Set it in .env or as an environment variable.\n" +
+            "Example: https://yourschool.instructure.com");
+    }
+    // Remove trailing slash if present
+    const normalizedBaseUrl = baseUrl.replace(/\/$/, "");
+    cachedConfig = {
+        apiToken,
+        baseUrl: normalizedBaseUrl,
+        studentId,
+    };
+    return cachedConfig;
+}
+/**
+ * Get config synchronously (must call loadConfig first)
+ */
+export function getConfig() {
+    if (!cachedConfig) {
+        throw new Error("Config not loaded. Call loadConfig() first.");
+    }
+    return cachedConfig;
+}
+/**
+ * Clear cached config (useful for testing)
+ */
+export function clearConfigCache() {
+    cachedConfig = null;
+}

package/esm/src/utils/init.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Initialization utility for CLI commands
+ */
+/**
+ * Initialize the Canvas API client
+ * Safe to call multiple times - will only init once
+ */
+export declare function ensureClient(): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/esm/src/utils/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/src/utils/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CASlD"}

package/esm/src/utils/init.js

@@ -0,0 +1,20 @@
+/**
+ * Initialization utility for CLI commands
+ */
+import { loadConfig } from "./config.js";
+import { initClient } from "../api/client.js";
+let initialized = false;
+/**
+ * Initialize the Canvas API client
+ * Safe to call multiple times - will only init once
+ */
+export async function ensureClient() {
+    if (initialized)
+        return;
+    const config = await loadConfig();
+    initClient({
+        baseUrl: config.baseUrl,
+        apiToken: config.apiToken,
+    });
+    initialized = true;
+}

package/manifest.json

@@ -0,0 +1,91 @@
+{
+  "manifest_version": "0.3",
+  "name": "canvas-lms-mcp",
+  "display_name": "Canvas LMS",
+  "version": "0.1.0",
+  "description": "Connect Claude to your Canvas LMS account to query grades, assignments, missing work, and more.",
+  "long_description": "An MCP server that connects AI assistants like Claude to your Canvas LMS account. Perfect for parents monitoring their child's academic progress, students tracking their own work, or anyone who wants to interact with Canvas data through natural language.\n\nAsk Claude things like:\n- What assignments are due this week?\n- Show me missing assignments across all classes\n- What's my grade in Biology?\n- Are there any late assignments I should know about?",
+  "author": {
+    "name": "mtgibbs",
+    "url": "https://github.com/mtgibbs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mtgibbs/canvas-lms-mcp"
+  },
+  "license": "MIT",
+  "privacy_policies": [
+    "https://github.com/mtgibbs/canvas-lms-mcp#privacy--security"
+  ],
+  "server": {
+    "type": "node",
+    "entry_point": "esm/cli.js",
+    "mcp_config": {
+      "command": "node",
+      "args": [
+        "${__dirname}/esm/cli.js"
+      ],
+      "env": {
+        "CANVAS_API_TOKEN": "${user_config.canvas_api_token}",
+        "CANVAS_BASE_URL": "${user_config.canvas_base_url}",
+        "CANVAS_STUDENT_ID": "${user_config.canvas_student_id}"
+      }
+    }
+  },
+  "user_config": {
+    "canvas_api_token": {
+      "type": "string",
+      "title": "Canvas API Token",
+      "description": "Your Canvas API access token. Generate one at Canvas > Account > Settings > Approved Integrations > New Access Token",
+      "sensitive": true,
+      "required": true
+    },
+    "canvas_base_url": {
+      "type": "string",
+      "title": "Canvas Base URL",
+      "description": "Your school's Canvas URL (e.g., https://yourschool.instructure.com)",
+      "required": true
+    },
+    "canvas_student_id": {
+      "type": "string",
+      "title": "Student ID (Optional)",
+      "description": "Required for parent/observer accounts. Leave empty if you're a student viewing your own data.",
+      "required": false,
+      "default": ""
+    }
+  },
+  "tools": [
+    {
+      "name": "get_courses",
+      "description": "List all courses with current grades"
+    },
+    {
+      "name": "get_missing_assignments",
+      "description": "Get assignments flagged as missing by Canvas"
+    },
+    {
+      "name": "get_unsubmitted_past_due",
+      "description": "Get past-due assignments not yet submitted"
+    },
+    {
+      "name": "get_upcoming_assignments",
+      "description": "Get assignments due soon for a specific course"
+    },
+    {
+      "name": "get_due_this_week",
+      "description": "Get all assignments due across all courses"
+    },
+    {
+      "name": "list_assignments",
+      "description": "Search and filter assignments by status"
+    },
+    {
+      "name": "get_stats",
+      "description": "Get late/missing statistics by course"
+    },
+    {
+      "name": "get_todo",
+      "description": "Get planner items and to-do list"
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@mtgibbs/canvas-lms-mcp",
+  "version": "0.1.0",
+  "description": "Canvas LMS MCP (Model Context Protocol) server for AI assistants. Query student grades, assignments, and academic data through Claude or other MCP-compatible AI tools.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "canvas-lms",
+    "canvas",
+    "lms",
+    "instructure",
+    "education",
+    "grades",
+    "assignments",
+    "claude",
+    "ai"
+  ],
+  "homepage": "https://github.com/mtgibbs/canvas-lms-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mtgibbs/canvas-lms-mcp.git"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/mtgibbs/canvas-lms-mcp/issues"
+  },
+  "module": "./esm/agent.js",
+  "exports": {
+    ".": {
+      "import": "./esm/agent.js"
+    }
+  },
+  "bin": {
+    "canvas-mcp": "./esm/cli.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@deno/shim-deno": "~0.18.0",
+    "dotenv": "^16.3.1",
+    "@modelcontextprotocol/sdk": "^1.0.1",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.9.0"
+  },
+  "_generatedBy": "dnt@dev"
+}