canvas-parent-mcp 2.1.10 → 2.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +2 -2
- package/.claude-plugin/plugin.json +1 -1
- package/README.md +10 -0
- package/dist/bundle.js +2503 -1574
- package/dist/index.js +8 -3
- package/dist/tools/_shared.js +4 -0
- package/dist/tools/announcements.js +2 -1
- package/dist/tools/assignments.js +5 -3
- package/dist/tools/calendar.js +3 -1
- package/dist/tools/conversations.js +3 -1
- package/dist/tools/courses.js +3 -1
- package/dist/tools/discussions.js +2 -1
- package/dist/tools/files.js +3 -1
- package/dist/tools/grades.js +2 -1
- package/dist/tools/observees.js +71 -0
- package/dist/tools/planner.js +65 -11
- package/dist/tools/profile.js +2 -0
- package/dist/tools/submissions.js +3 -1
- package/mint.yaml +9 -4
- package/package.json +5 -1
- package/server.json +2 -2
package/dist/index.js
CHANGED
|
@@ -11,7 +11,7 @@ import { resolveAuth } from './auth.js';
|
|
|
11
11
|
import { registerHealthcheckTools } from './tools/healthcheck.js';
|
|
12
12
|
import { CanvasClient } from './client.js';
|
|
13
13
|
import { registerProfileTools } from './tools/profile.js';
|
|
14
|
-
import { registerObserveeTools } from './tools/observees.js';
|
|
14
|
+
import { registerObserveeTools, loadObserveeDirectory } from './tools/observees.js';
|
|
15
15
|
import { registerCourseTools } from './tools/courses.js';
|
|
16
16
|
import { registerAssignmentTools } from './tools/assignments.js';
|
|
17
17
|
import { registerSubmissionTools } from './tools/submissions.js';
|
|
@@ -46,6 +46,11 @@ catch (e) {
|
|
|
46
46
|
const client = resolved
|
|
47
47
|
? new CanvasClient(resolved.account, { refreshSession: resolved.refresh })
|
|
48
48
|
: null;
|
|
49
|
+
// The planner's `observeeId` publishes the observees' display names as an
|
|
50
|
+
// enum (context groups, mcp-host spec 2026-11-03 D5), so list them ONCE here —
|
|
51
|
+
// registrars run per served instance — bounded by OBSERVEE_LIST_TIMEOUT_MS.
|
|
52
|
+
// Null (failure, timeout, nobody observed) publishes the property with no enum.
|
|
53
|
+
const observees = client ? await loadObserveeDirectory(client) : null;
|
|
49
54
|
// `runMcp` (from @chrischall/mcp-utils) builds the McpServer, runs the
|
|
50
55
|
// registrar, then connects the stdio transport and installs SIGINT/SIGTERM
|
|
51
56
|
// shutdown handlers. The deferred-config-error pattern is preserved by
|
|
@@ -54,7 +59,7 @@ const client = resolved
|
|
|
54
59
|
// host's install-time `tools/list` succeeds.
|
|
55
60
|
await runMcp({
|
|
56
61
|
name: 'canvas',
|
|
57
|
-
version: '2.
|
|
62
|
+
version: '2.2.0', // x-release-please-version
|
|
58
63
|
tools: [
|
|
59
64
|
// Outside the `if (resolved)` on purpose: an unconfigured server must
|
|
60
65
|
// still expose something that can say WHY (see the tool's docblock).
|
|
@@ -68,7 +73,7 @@ await runMcp({
|
|
|
68
73
|
registerSubmissionTools(server, client);
|
|
69
74
|
registerGradeTools(server, client);
|
|
70
75
|
registerCalendarTools(server, client);
|
|
71
|
-
registerPlannerTools(server, client);
|
|
76
|
+
registerPlannerTools(server, client, observees);
|
|
72
77
|
registerAnnouncementTools(server, client);
|
|
73
78
|
registerConversationTools(server, client);
|
|
74
79
|
registerDiscussionTools(server, client);
|
package/dist/tools/_shared.js
CHANGED
|
@@ -29,3 +29,7 @@ export function buildPath(base, params = {}) {
|
|
|
29
29
|
export function userSegment(observeeId) {
|
|
30
30
|
return observeeId ? `users/${encodeURIComponent(observeeId)}` : 'users/self';
|
|
31
31
|
}
|
|
32
|
+
/** `_meta` for a Canvas tool: every tool here is in the `school` domain. */
|
|
33
|
+
export function schoolMeta(intent, extra = {}) {
|
|
34
|
+
return { mint: { domain: 'school', intent, ...extra } };
|
|
35
|
+
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
-
import { buildPath } from './_shared.js';
|
|
2
|
+
import { buildPath, schoolMeta } from './_shared.js';
|
|
3
3
|
import { viewArg, viewResponse } from '../view.js';
|
|
4
4
|
const argsSchema = z.object({
|
|
5
5
|
contextCodes: z.array(z.string()).describe('Required. Array like ["course_123", "course_456"].'),
|
|
@@ -12,6 +12,7 @@ export function registerAnnouncementTools(server, client) {
|
|
|
12
12
|
server.registerTool('canvas_list_announcements', {
|
|
13
13
|
description: "List announcements across one or more courses. `contextCodes` is required (e.g. [\"course_123\"]). Defaults to active-only.",
|
|
14
14
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
15
|
+
_meta: schoolMeta('whats-new', { canonical: true, aliases: ['teacher', 'announcements', 'news'] }),
|
|
15
16
|
inputSchema: argsSchema,
|
|
16
17
|
}, async (rawArgs) => {
|
|
17
18
|
const args = argsSchema.parse(rawArgs);
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
-
import { textContent, buildPath, userSegment } from './_shared.js';
|
|
2
|
+
import { textContent, buildPath, userSegment, schoolMeta } from './_shared.js';
|
|
3
3
|
const listArgs = z.object({
|
|
4
4
|
courseId: z.string(),
|
|
5
5
|
bucket: z.enum(['past', 'overdue', 'undated', 'ungraded', 'unsubmitted', 'upcoming', 'future']).optional()
|
|
@@ -11,8 +11,9 @@ const missingArgs = z.object({
|
|
|
11
11
|
});
|
|
12
12
|
export function registerAssignmentTools(server, client) {
|
|
13
13
|
server.registerTool('canvas_list_assignments', {
|
|
14
|
-
description: "List a course's assignments
|
|
14
|
+
description: "List a course's assignments — homework, quizzes and projects — with the user's (or child's) submission inline. Supports the standard Canvas `bucket` filter.",
|
|
15
15
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
16
|
+
_meta: schoolMeta('lookup'),
|
|
16
17
|
inputSchema: listArgs,
|
|
17
18
|
}, async (rawArgs) => {
|
|
18
19
|
const args = listArgs.parse(rawArgs);
|
|
@@ -25,8 +26,9 @@ export function registerAssignmentTools(server, client) {
|
|
|
25
26
|
return textContent(data);
|
|
26
27
|
});
|
|
27
28
|
server.registerTool('canvas_list_missing_submissions', {
|
|
28
|
-
description: "List past-due unsubmitted assignments for the user (or a linked observee). For an observee, courseIds is required.",
|
|
29
|
+
description: "List missing homework: past-due unsubmitted assignments for the user (or a linked observee, e.g. a child). For an observee, courseIds is required.",
|
|
29
30
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
31
|
+
_meta: schoolMeta('whats-due'),
|
|
30
32
|
inputSchema: missingArgs,
|
|
31
33
|
}, async (rawArgs) => {
|
|
32
34
|
const args = missingArgs.parse(rawArgs);
|
package/dist/tools/calendar.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
-
import { textContent, buildPath } from './_shared.js';
|
|
2
|
+
import { textContent, buildPath, schoolMeta } from './_shared.js';
|
|
3
3
|
const eventsArgs = z.object({
|
|
4
4
|
contextCodes: z.array(z.string()).optional().describe('Array like ["course_123", "user_456"].'),
|
|
5
5
|
type: z.enum(['event', 'assignment']).optional(),
|
|
@@ -11,6 +11,7 @@ export function registerCalendarTools(server, client) {
|
|
|
11
11
|
server.registerTool('canvas_list_calendar_events', {
|
|
12
12
|
description: 'List Canvas calendar events or assignments across selected contexts (courses/users).',
|
|
13
13
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
14
|
+
_meta: schoolMeta('whats-on'),
|
|
14
15
|
inputSchema: eventsArgs,
|
|
15
16
|
}, async (rawArgs) => {
|
|
16
17
|
const args = eventsArgs.parse(rawArgs);
|
|
@@ -27,6 +28,7 @@ export function registerCalendarTools(server, client) {
|
|
|
27
28
|
server.registerTool('canvas_list_upcoming_events', {
|
|
28
29
|
description: "List the calling user's upcoming events (Canvas's curated next-7-days view).",
|
|
29
30
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
31
|
+
_meta: schoolMeta('whats-on'),
|
|
30
32
|
}, async () => {
|
|
31
33
|
const data = await client.request('/api/v1/users/self/upcoming_events');
|
|
32
34
|
return textContent(data);
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
-
import { buildPath } from './_shared.js';
|
|
2
|
+
import { buildPath, schoolMeta } from './_shared.js';
|
|
3
3
|
import { viewArg, viewResponse } from '../view.js';
|
|
4
4
|
const listArgs = z.object({
|
|
5
5
|
scope: z.enum(['unread', 'starred', 'archived', 'sent']).optional(),
|
|
@@ -14,6 +14,7 @@ export function registerConversationTools(server, client) {
|
|
|
14
14
|
server.registerTool('canvas_list_conversations', {
|
|
15
15
|
description: "List Canvas inbox conversations. Optional `scope` (unread/starred/archived/sent) and `filter` (array of context codes).",
|
|
16
16
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
17
|
+
_meta: schoolMeta('lookup'),
|
|
17
18
|
inputSchema: listArgs,
|
|
18
19
|
}, async (rawArgs) => {
|
|
19
20
|
const args = listArgs.parse(rawArgs);
|
|
@@ -28,6 +29,7 @@ export function registerConversationTools(server, client) {
|
|
|
28
29
|
server.registerTool('canvas_get_conversation', {
|
|
29
30
|
description: 'Get a full Canvas conversation thread with all messages. Read-only: does not mark the conversation as read.',
|
|
30
31
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
32
|
+
_meta: schoolMeta('lookup'),
|
|
31
33
|
inputSchema: getArgs,
|
|
32
34
|
}, async (rawArgs) => {
|
|
33
35
|
const args = getArgs.parse(rawArgs);
|
package/dist/tools/courses.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
-
import { textContent, buildPath, userSegment } from './_shared.js';
|
|
2
|
+
import { textContent, buildPath, userSegment, schoolMeta } from './_shared.js';
|
|
3
3
|
import { viewArg, viewResponse } from '../view.js';
|
|
4
4
|
const listArgs = z.object({
|
|
5
5
|
observeeId: z.string().optional().describe("Observed student's user ID; omit for self."),
|
|
@@ -12,6 +12,7 @@ export function registerCourseTools(server, client) {
|
|
|
12
12
|
server.registerTool('canvas_list_courses', {
|
|
13
13
|
description: 'List active Canvas courses (with course-level grades, total scores, current grading period scores, and term).',
|
|
14
14
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
15
|
+
_meta: schoolMeta('lookup'),
|
|
15
16
|
inputSchema: listArgs,
|
|
16
17
|
}, async (rawArgs) => {
|
|
17
18
|
const args = listArgs.parse(rawArgs);
|
|
@@ -26,6 +27,7 @@ export function registerCourseTools(server, client) {
|
|
|
26
27
|
server.registerTool('canvas_get_course', {
|
|
27
28
|
description: 'Get a single Canvas course with its syllabus, teachers, and term.',
|
|
28
29
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
30
|
+
_meta: schoolMeta('lookup'),
|
|
29
31
|
inputSchema: getArgs,
|
|
30
32
|
}, async (rawArgs) => {
|
|
31
33
|
const args = getArgs.parse(rawArgs);
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
-
import { buildPath } from './_shared.js';
|
|
2
|
+
import { buildPath, schoolMeta } from './_shared.js';
|
|
3
3
|
import { viewArg, viewResponse } from '../view.js';
|
|
4
4
|
const argsSchema = z.object({
|
|
5
5
|
courseId: z.string(),
|
|
@@ -11,6 +11,7 @@ export function registerDiscussionTools(server, client) {
|
|
|
11
11
|
server.registerTool('canvas_list_discussion_topics', {
|
|
12
12
|
description: 'List discussion topics for a course (read-only).',
|
|
13
13
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
14
|
+
_meta: schoolMeta('lookup'),
|
|
14
15
|
inputSchema: argsSchema,
|
|
15
16
|
}, async (rawArgs) => {
|
|
16
17
|
const args = argsSchema.parse(rawArgs);
|
package/dist/tools/files.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
-
import { textContent, buildPath } from './_shared.js';
|
|
2
|
+
import { textContent, buildPath, schoolMeta } from './_shared.js';
|
|
3
3
|
const listArgs = z.object({
|
|
4
4
|
courseId: z.string(),
|
|
5
5
|
searchTerm: z.string().optional(),
|
|
@@ -14,6 +14,7 @@ export function registerFileTools(server, client) {
|
|
|
14
14
|
server.registerTool('canvas_list_course_files', {
|
|
15
15
|
description: "List a course's files (metadata only — use canvas_download_file with the `url` field).",
|
|
16
16
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
17
|
+
_meta: schoolMeta('lookup'),
|
|
17
18
|
inputSchema: listArgs,
|
|
18
19
|
}, async (rawArgs) => {
|
|
19
20
|
const args = listArgs.parse(rawArgs);
|
|
@@ -27,6 +28,7 @@ export function registerFileTools(server, client) {
|
|
|
27
28
|
server.registerTool('canvas_download_file', {
|
|
28
29
|
description: "Download a Canvas file to disk. `url` is the absolute URL from canvas_list_course_files (only file URLs on the configured Canvas host are accepted); `destinationPath` is required and must be inside the download directory (CANVAS_OUTPUT_DIR, default ~/Downloads).",
|
|
29
30
|
annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
|
|
31
|
+
_meta: schoolMeta('other'),
|
|
30
32
|
inputSchema: downloadArgs,
|
|
31
33
|
}, async (rawArgs) => {
|
|
32
34
|
const args = downloadArgs.parse(rawArgs);
|
package/dist/tools/grades.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
-
import { textContent, buildPath, userSegment } from './_shared.js';
|
|
2
|
+
import { textContent, buildPath, userSegment, schoolMeta } from './_shared.js';
|
|
3
3
|
const argsSchema = z.object({
|
|
4
4
|
observeeId: z.string().optional(),
|
|
5
5
|
});
|
|
@@ -7,6 +7,7 @@ export function registerGradeTools(server, client) {
|
|
|
7
7
|
server.registerTool('canvas_list_enrollments', {
|
|
8
8
|
description: 'List active student enrollments with per-course grades (current_score, final_score, current_grade, final_grade, current grading period info).',
|
|
9
9
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
10
|
+
_meta: schoolMeta('lookup'),
|
|
10
11
|
inputSchema: argsSchema,
|
|
11
12
|
}, async (rawArgs) => {
|
|
12
13
|
const args = argsSchema.parse(rawArgs);
|
package/dist/tools/observees.js
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
2
|
import { viewArg, viewResponse } from '../view.js';
|
|
3
|
+
import { schoolMeta } from './_shared.js';
|
|
3
4
|
const argsSchema = z.object({
|
|
4
5
|
view: viewArg(),
|
|
5
6
|
});
|
|
@@ -7,6 +8,7 @@ export function registerObserveeTools(server, client) {
|
|
|
7
8
|
server.registerTool('canvas_list_observees', {
|
|
8
9
|
description: "List students linked to your Canvas observer account. Returns an empty array for plain student tokens.",
|
|
9
10
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
11
|
+
_meta: schoolMeta('lookup'),
|
|
10
12
|
inputSchema: argsSchema,
|
|
11
13
|
}, async (rawArgs) => {
|
|
12
14
|
const args = argsSchema.parse(rawArgs);
|
|
@@ -14,3 +16,72 @@ export function registerObserveeTools(server, client) {
|
|
|
14
16
|
return viewResponse(args.view, data);
|
|
15
17
|
});
|
|
16
18
|
}
|
|
19
|
+
/** Bound on the start-time listing: a host must not wait on it to list tools. */
|
|
20
|
+
export const OBSERVEE_LIST_TIMEOUT_MS = 5_000;
|
|
21
|
+
function readObservees(data) {
|
|
22
|
+
if (!Array.isArray(data))
|
|
23
|
+
return [];
|
|
24
|
+
const out = [];
|
|
25
|
+
for (const row of data) {
|
|
26
|
+
if (!row || typeof row !== 'object')
|
|
27
|
+
continue;
|
|
28
|
+
const r = row;
|
|
29
|
+
if (typeof r.id !== 'string' && typeof r.id !== 'number')
|
|
30
|
+
continue;
|
|
31
|
+
const id = String(r.id);
|
|
32
|
+
const name = [r.name, r.short_name].find((v) => typeof v === 'string' && v.trim() !== '');
|
|
33
|
+
out.push({ id, label: name?.trim() ?? id });
|
|
34
|
+
}
|
|
35
|
+
return out;
|
|
36
|
+
}
|
|
37
|
+
function buildDirectory(users) {
|
|
38
|
+
if (users.length === 0)
|
|
39
|
+
return null;
|
|
40
|
+
const counts = new Map();
|
|
41
|
+
for (const u of users)
|
|
42
|
+
counts.set(u.label.toLowerCase(), (counts.get(u.label.toLowerCase()) ?? 0) + 1);
|
|
43
|
+
// Two children with one display name would make the name ambiguous, so each
|
|
44
|
+
// carries its id; the label stays resolvable and never picks the wrong child.
|
|
45
|
+
const labelled = users.map((u) => ({
|
|
46
|
+
id: u.id,
|
|
47
|
+
label: counts.get(u.label.toLowerCase()) > 1 ? `${u.label} (${u.id})` : u.label,
|
|
48
|
+
}));
|
|
49
|
+
const byLabel = new Map(labelled.map((u) => [u.label.toLowerCase(), u.id]));
|
|
50
|
+
const ids = new Set(labelled.map((u) => u.id));
|
|
51
|
+
const labels = labelled.map((u) => u.label);
|
|
52
|
+
return {
|
|
53
|
+
labels,
|
|
54
|
+
resolve(value) {
|
|
55
|
+
const id = byLabel.get(value.trim().toLowerCase());
|
|
56
|
+
if (id !== undefined)
|
|
57
|
+
return id;
|
|
58
|
+
if (ids.has(value.trim()))
|
|
59
|
+
return value.trim();
|
|
60
|
+
throw new Error(`Unknown observee "${value}". Known: ${labels.join(', ')}.`);
|
|
61
|
+
},
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* List the observees ONCE, at server start, for the planner's `observeeId`
|
|
66
|
+
* enum. Answers null — so the property is published with no `enum` keyword,
|
|
67
|
+
* never an empty one — when the account observes nobody, when the listing
|
|
68
|
+
* fails (no browser for the fetchproxy path, a dead credential), or when it has
|
|
69
|
+
* not answered within `timeoutMs`. Never throws.
|
|
70
|
+
*/
|
|
71
|
+
export async function loadObserveeDirectory(client, timeoutMs = OBSERVEE_LIST_TIMEOUT_MS) {
|
|
72
|
+
let timer;
|
|
73
|
+
const deadline = new Promise((resolve) => {
|
|
74
|
+
timer = setTimeout(() => resolve(null), timeoutMs);
|
|
75
|
+
timer.unref();
|
|
76
|
+
});
|
|
77
|
+
const listing = client
|
|
78
|
+
.requestPaginated('/api/v1/users/self/observees')
|
|
79
|
+
.then((data) => buildDirectory(readObservees(data)))
|
|
80
|
+
.catch(() => null);
|
|
81
|
+
try {
|
|
82
|
+
return await Promise.race([listing, deadline]);
|
|
83
|
+
}
|
|
84
|
+
finally {
|
|
85
|
+
clearTimeout(timer);
|
|
86
|
+
}
|
|
87
|
+
}
|
package/dist/tools/planner.js
CHANGED
|
@@ -1,21 +1,72 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
-
import { textContent, buildPath } from './_shared.js';
|
|
3
|
-
const
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
2
|
+
import { textContent, buildPath, schoolMeta } from './_shared.js';
|
|
3
|
+
const OBSERVEE_DESCRIPTION = "A linked observee (child): their display name as listed, or their Canvas user id. Omit for your own planner.";
|
|
4
|
+
/**
|
|
5
|
+
* `observeeId` publishes the observee LABELS as a JSON Schema `enum` when the
|
|
6
|
+
* server could list them at start (mcp-host spec D5), via `.meta()` — so the
|
|
7
|
+
* runtime schema is still any string and the handler accepts a label or an id.
|
|
8
|
+
* With no listing the property is published plain: an empty `enum` is invalid
|
|
9
|
+
* JSON Schema.
|
|
10
|
+
*/
|
|
11
|
+
function observeeIdArg(observees) {
|
|
12
|
+
const base = z.string();
|
|
13
|
+
return (observees ? base.meta({ enum: observees.labels }) : base).optional().describe(OBSERVEE_DESCRIPTION);
|
|
14
|
+
}
|
|
15
|
+
const BRIEF_MAX = 120;
|
|
16
|
+
function str(v) {
|
|
17
|
+
return typeof v === 'string' && v.trim() !== '' ? v.trim() : undefined;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* One planner item as one line, `title — due <ISO date | no date> — <status>`,
|
|
21
|
+
* at most 120 characters (the title is shortened). Read only from the fields
|
|
22
|
+
* Canvas's planner item carries: `plannable.title`/`name`, `plannable.due_at`
|
|
23
|
+
* (else `plannable_date`), and `submissions`. An item with no submission at
|
|
24
|
+
* all (`submissions: false` — a note, a page, an event) gets no status, since
|
|
25
|
+
* "not submitted" would be untrue of something nobody submits.
|
|
26
|
+
*/
|
|
27
|
+
export function briefLine(item) {
|
|
28
|
+
const it = (item && typeof item === 'object' ? item : {});
|
|
29
|
+
const p = (it.plannable && typeof it.plannable === 'object' ? it.plannable : {});
|
|
30
|
+
const title = str(p.title) ?? str(p.name) ?? str(it.title) ?? '(untitled)';
|
|
31
|
+
const due = str(p.due_at) ?? str(it.plannable_date) ?? 'no date';
|
|
32
|
+
const sub = it.submissions;
|
|
33
|
+
let status = '';
|
|
34
|
+
if (sub && typeof sub === 'object') {
|
|
35
|
+
const s = sub;
|
|
36
|
+
status = s.missing === true ? 'missing' : s.submitted === true ? 'submitted' : 'not submitted';
|
|
37
|
+
}
|
|
38
|
+
const tail = ` — due ${due}${status ? ` — ${status}` : ''}`;
|
|
39
|
+
const room = BRIEF_MAX - tail.length;
|
|
40
|
+
const shown = title.length > room ? `${title.slice(0, Math.max(room - 1, 0))}…` : title;
|
|
41
|
+
return `${shown}${tail}`;
|
|
42
|
+
}
|
|
43
|
+
export function registerPlannerTools(server, client, observees) {
|
|
44
|
+
const argsSchema = z.object({
|
|
45
|
+
observeeId: observeeIdArg(observees),
|
|
46
|
+
startDate: z.string().optional(),
|
|
47
|
+
endDate: z.string().optional(),
|
|
48
|
+
contextCodes: z.array(z.string()).optional(),
|
|
49
|
+
filter: z.enum(['new_activity']).optional(),
|
|
50
|
+
view: z.enum(['full', 'brief']).optional().describe('"full" (default) returns Canvas\'s planner items verbatim; "brief" returns one line per item: ' +
|
|
51
|
+
'title — due <ISO date or "no date"> — <submitted|not submitted|missing>.'),
|
|
52
|
+
});
|
|
11
53
|
server.registerTool('canvas_list_planner_items', {
|
|
12
54
|
description: "List planner items (assignments + announcements + planner notes + calendar events) for the user or a linked observee.",
|
|
13
55
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
56
|
+
_meta: schoolMeta('whats-due', {
|
|
57
|
+
canonical: true,
|
|
58
|
+
subject: 'observeeId',
|
|
59
|
+
when: { start: 'startDate', end: 'endDate' },
|
|
60
|
+
aliases: ['homework', 'assignments', 'due', 'kids', 'school'],
|
|
61
|
+
}),
|
|
14
62
|
inputSchema: argsSchema,
|
|
15
63
|
}, async (rawArgs) => {
|
|
16
64
|
const args = argsSchema.parse(rawArgs);
|
|
17
|
-
const
|
|
18
|
-
?
|
|
65
|
+
const observeeId = args.observeeId !== undefined && observees
|
|
66
|
+
? observees.resolve(args.observeeId)
|
|
67
|
+
: args.observeeId;
|
|
68
|
+
const base = observeeId
|
|
69
|
+
? `/api/v1/users/${encodeURIComponent(observeeId)}/planner/items`
|
|
19
70
|
: '/api/v1/planner/items';
|
|
20
71
|
const path = buildPath(base, {
|
|
21
72
|
start_date: args.startDate,
|
|
@@ -24,6 +75,9 @@ export function registerPlannerTools(server, client) {
|
|
|
24
75
|
filter: args.filter,
|
|
25
76
|
});
|
|
26
77
|
const data = await client.requestPaginated(path);
|
|
78
|
+
if (args.view === 'brief') {
|
|
79
|
+
return { content: [{ type: 'text', text: data.map(briefLine).join('\n') }] };
|
|
80
|
+
}
|
|
27
81
|
return textContent(data);
|
|
28
82
|
});
|
|
29
83
|
}
|
package/dist/tools/profile.js
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
+
import { schoolMeta } from './_shared.js';
|
|
2
3
|
import { viewArg, viewResponse } from '../view.js';
|
|
3
4
|
const argsSchema = z.object({
|
|
4
5
|
view: viewArg(),
|
|
@@ -7,6 +8,7 @@ export function registerProfileTools(server, client) {
|
|
|
7
8
|
server.registerTool('canvas_get_profile', {
|
|
8
9
|
description: "Get the logged-in user's Canvas profile (id, name, primary_email, login_id, locale, time_zone). Useful first call to confirm credentials.",
|
|
9
10
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
11
|
+
_meta: schoolMeta('lookup'),
|
|
10
12
|
inputSchema: argsSchema,
|
|
11
13
|
}, async (rawArgs) => {
|
|
12
14
|
const args = argsSchema.parse(rawArgs);
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { z } from 'zod';
|
|
2
|
-
import { buildPath } from './_shared.js';
|
|
2
|
+
import { buildPath, schoolMeta } from './_shared.js';
|
|
3
3
|
import { viewArg, viewResponse } from '../view.js';
|
|
4
4
|
const getArgs = z.object({
|
|
5
5
|
courseId: z.string(),
|
|
@@ -17,6 +17,7 @@ export function registerSubmissionTools(server, client) {
|
|
|
17
17
|
server.registerTool('canvas_get_submission', {
|
|
18
18
|
description: "Get a single submission with rubric assessment and grader comments. userId defaults to 'self'.",
|
|
19
19
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
20
|
+
_meta: schoolMeta('lookup'),
|
|
20
21
|
inputSchema: getArgs,
|
|
21
22
|
}, async (rawArgs) => {
|
|
22
23
|
const args = getArgs.parse(rawArgs);
|
|
@@ -28,6 +29,7 @@ export function registerSubmissionTools(server, client) {
|
|
|
28
29
|
server.registerTool('canvas_list_recent_submissions', {
|
|
29
30
|
description: "List recently graded submissions in a course. Defaults to a 14-day window for the calling user.",
|
|
30
31
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
32
|
+
_meta: schoolMeta('lookup'),
|
|
31
33
|
inputSchema: recentArgs,
|
|
32
34
|
}, async (rawArgs) => {
|
|
33
35
|
const args = recentArgs.parse(rawArgs);
|
package/mint.yaml
CHANGED
|
@@ -2,10 +2,15 @@ version: 1
|
|
|
2
2
|
name: Canvas Parent
|
|
3
3
|
slug: canvas-parent
|
|
4
4
|
summary: >-
|
|
5
|
-
Canvas LMS courses, assignments, grades and messages
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
5
|
+
Canvas LMS courses, assignments, grades, announcements, calendar and messages
|
|
6
|
+
for a parent/observer. Signs in with a token, OAuth or password; the
|
|
7
|
+
browser-bridge fallback needs a signed-in browser.
|
|
8
|
+
examples:
|
|
9
|
+
- prompt: Which assignments are missing or past due for my kids on Canvas right now?
|
|
10
|
+
note: Uses the observee list, then missing submissions per course.
|
|
11
|
+
- prompt: What are my child's current grades in each Canvas course?
|
|
12
|
+
- prompt: What's due on Canvas in the next two weeks, and are there any new teacher announcements?
|
|
13
|
+
note: Combines planner items with recent course announcements.
|
|
9
14
|
command:
|
|
10
15
|
# REQUIRED: package.json declares canvas-parent-mcp (the server) and
|
|
11
16
|
# canvas-parent-mcp-qr-login (a local CLI). Without this the install refuses.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "canvas-parent-mcp",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.2.0",
|
|
4
4
|
"mcpName": "io.github.chrischall/canvas-parent-mcp",
|
|
5
5
|
"description": "Canvas LMS (Instructure) MCP server — student/observer read access with optional file download",
|
|
6
6
|
"author": "Claude Code (AI) <https://www.anthropic.com/claude>",
|
|
@@ -61,5 +61,9 @@
|
|
|
61
61
|
"esbuild": "^0.28.0",
|
|
62
62
|
"typescript": "^7.0.2",
|
|
63
63
|
"vitest": "^5.0.0"
|
|
64
|
+
},
|
|
65
|
+
"allowScripts": {
|
|
66
|
+
"esbuild": false,
|
|
67
|
+
"fsevents": false
|
|
64
68
|
}
|
|
65
69
|
}
|
package/server.json
CHANGED
|
@@ -6,12 +6,12 @@
|
|
|
6
6
|
"url": "https://github.com/chrischall/canvas-parent-mcp",
|
|
7
7
|
"source": "github"
|
|
8
8
|
},
|
|
9
|
-
"version": "2.
|
|
9
|
+
"version": "2.2.0",
|
|
10
10
|
"packages": [
|
|
11
11
|
{
|
|
12
12
|
"registryType": "npm",
|
|
13
13
|
"identifier": "canvas-parent-mcp",
|
|
14
|
-
"version": "2.
|
|
14
|
+
"version": "2.2.0",
|
|
15
15
|
"transport": {
|
|
16
16
|
"type": "stdio"
|
|
17
17
|
},
|