brightspace-mcp-server 3.0.4 → 3.2.0

package/build/utils/transcript/youtube.js

@@ -0,0 +1,57 @@
+/**
+ * Purdue Brightspace MCP Server
+ * Copyright (c) 2026 Rohan Muppa. All rights reserved.
+ * Licensed under MIT — see LICENSE file for details.
+ */
+/**
+ * YouTube transcript retrieval via its public timedtext endpoint. No
+ * authentication is needed — this is the same caption track a signed-out
+ * browser can fetch — so unlike Kaltura there is no session to reuse or fail
+ * to obtain.
+ */
+import { parseCaptions } from "./captions.js";
+import { NoTranscriptError, TranscriptFetchError } from "./errors.js";
+const TIMEDTEXT_BASE = "https://www.youtube.com/api/timedtext";
+async function listCaptionTracks(videoId, fetchImpl) {
+    const res = await fetchImpl(`${TIMEDTEXT_BASE}?type=list&v=${encodeURIComponent(videoId)}`);
+    if (!res.ok) {
+        throw new TranscriptFetchError(`YouTube caption list request failed (HTTP ${res.status}).`);
+    }
+    const xml = await res.text();
+    return [...xml.matchAll(/<track\b[^>]*\blang_code="([^"]+)"/g)].map((m) => m[1]);
+}
+async function fetchTitle(videoId, fetchImpl) {
+    try {
+        const watchUrl = `https://www.youtube.com/watch?v=${encodeURIComponent(videoId)}`;
+        const res = await fetchImpl(`https://www.youtube.com/oembed?url=${encodeURIComponent(watchUrl)}&format=json`);
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return data.title ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function getYouTubeTranscript(videoId, fetchImpl) {
+    const tracks = await listCaptionTracks(videoId, fetchImpl);
+    if (tracks.length === 0) {
+        throw new NoTranscriptError("This YouTube video has no caption tracks available.");
+    }
+    const lang = tracks.find((t) => t.startsWith("en")) ?? tracks[0];
+    const res = await fetchImpl(`${TIMEDTEXT_BASE}?lang=${encodeURIComponent(lang)}&v=${encodeURIComponent(videoId)}&fmt=vtt`);
+    if (!res.ok) {
+        throw new TranscriptFetchError(`YouTube caption download failed (HTTP ${res.status}).`);
+    }
+    const vtt = await res.text();
+    if (!vtt.trim()) {
+        throw new NoTranscriptError("This YouTube video has no caption tracks available.");
+    }
+    const { format, cues } = parseCaptions(vtt);
+    if (cues.length === 0) {
+        throw new NoTranscriptError("This YouTube video has a caption track, but it contained no readable cues.");
+    }
+    const title = await fetchTitle(videoId, fetchImpl);
+    return { cues, format, language: lang, title, durationSeconds: null };
+}
+//# sourceMappingURL=youtube.js.map

package/build/utils/transcript/youtube.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube.js","sourceRoot":"","sources":["../../../src/utils/transcript/youtube.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brightspace-mcp-server",
-  "version": "3.0.4",
+  "version": "3.2.0",
   "mcpName": "io.github.rohanmuppa/brightspace",
   "description": "MCP server for Brightspace (D2L). Check grades, due dates, assignments, announcements, syllabus, rosters and more via Claude, ChatGPT, Cursor, Windsurf, or any MCP client.",
   "type": "module",