brightspace-mcp-server 5.0.7 → 5.0.8

package/README.md

@@ -136,6 +136,7 @@ Things that change:
 - **Settings go to the server, not to Codex.** A URL entry has no process to pass an `env` table to, so `D2L_*` settings (the [table above](#settings-you-might-want)) are set in the terminal that runs `http`, in a `.env` file in the directory you start it from, or saved by `setup`.
 - **Sign-in messages show up in the server's terminal.** The number to approve still comes back in the chat's answer, and, in clients that show tool progress, while the question is running.
 - **Stopping it:** press Ctrl+C. Questions already running finish first; press Ctrl+C again to stop at once.
+- **Updating it:** restart the server, not Codex. Restarting a client only reconnects it to the server that is already running the old version. Stop the server and start the same `http` command again with the same `D2L_HTTP_TOKEN`, port, and settings; from a source checkout, run `npm run update` first. Update notices from a shared server say this too.
 
 Any other MCP client that can connect to a Streamable HTTP URL with a bearer token can share the same server. To go back to one copy per chat, put the `command`/`args` entry back (rerunning `setup` does it) and stop the shared server.
 

package/build/index.js

@@ -75,7 +75,7 @@ else {
             // Check for updates now, then every few hours. A stdio server can stay
             // alive for days, so a boot-only check would never see a release. The
             // interval is unref'd and cannot hold the process open.
-            startUpdateChecks();
+            startUpdateChecks({ transport: http ? "http" : "stdio" });
             // Log active course filter config if any filter is set
             if (config.courseFilter.includeCourseIds || config.courseFilter.excludeCourseIds || !config.courseFilter.activeOnly) {
                 log("DEBUG", "Course filter config", {

package/build/update.js

@@ -312,6 +312,11 @@ export function main() {
     }
     console.log("");
     console.log("  Restart your MCP client to use the latest version.");
+    console.log("  If you run the shared HTTP server, restart the server instead: a client restart only");
+    console.log("  reconnects to the old process. Stop it, start node build/index.js http again with the");
+    console.log("  same D2L_HTTP_TOKEN, port, and D2L_* settings, and reconnect any client that does not.");
+    console.log(dim("  A chat already connected over stdio keeps its own copy and cannot move onto the shared"));
+    console.log(dim("  server mid-session; restart its client to load the new build."));
     console.log("");
 }
 // `npm run update` runs this file directly. VITEST is set only by the test

package/build/utils/update-checker.js

@@ -20,7 +20,11 @@
  *
  * A source checkout gets different advice: installing the npm package would
  * update some other copy, and for a fork it would mean leaving its changes
- * behind. Such a checkout is told to pull and rebuild, or to opt out.
+ * behind. Such a checkout is told to run its own updater, or to opt out.
+ *
+ * What to restart depends on the transport: a stdio server dies with its
+ * client, but the shared HTTP server outlives every client and must itself be
+ * restarted.
  *
  * Set D2L_NO_UPDATE_CHECK to any value to switch the check off entirely.
  */
@@ -162,13 +166,37 @@ export async function fetchLatestVersion(fetchImpl = fetch) {
         return null;
     }
 }
+/** The command that starts the shared HTTP server from each kind of install. */
+const HTTP_START_COMMAND = {
+    "npx-cache": `npx -y ${PACKAGE_NAME}@latest http`,
+    "npm-install": `${PACKAGE_NAME} http`,
+    "source-checkout": "node build/index.js http",
+};
+/**
+ * What to restart so the new version actually runs. A stdio server lives as
+ * long as its client, so restarting the client is enough. The shared HTTP
+ * server outlives every client: restarting one only reconnects it to the same
+ * old process, so the server itself has to be restarted, with the token and
+ * port its clients already use.
+ */
+function reloadStep(installKind, transport, to, afterAStep) {
+    // "Then" only follows an update step; an npx install with no stale cache to
+    // clear has none, so the restart is the first thing to do.
+    const restart = afterAStep ? "Then restart" : "Restart";
+    if (transport === "stdio")
+        return `${restart} your MCP client to pick up v${to}.`;
+    return `${restart} the shared HTTP server to pick up v${to}: restarting an MCP client only reconnects it ` +
+        `to this running server. Stop it (Ctrl+C where it runs, or stop its service), then start it again with ` +
+        `${HTTP_START_COMMAND[installKind]}, using the same D2L_HTTP_TOKEN, port, and D2L_* settings, ` +
+        `and reconnect any client that does not reconnect on its own.`;
+}
 /**
  * Run one update check. Never throws and never blocks the caller for long:
  * the registry request is bounded by a timeout and every failure is
  * swallowed, because a version check must not affect the server.
  */
 export async function initUpdateChecker(deps = {}) {
-    const { fetchImpl = fetch, env = process.env, installedVersion = getInstalledVersion(), installKind = installKindOf(), clearCaches = () => clearAllNpxCaches(), } = deps;
+    const { fetchImpl = fetch, env = process.env, installedVersion = getInstalledVersion(), installKind = installKindOf(), clearCaches = () => clearAllNpxCaches(), transport = "stdio", } = deps;
     if (env.D2L_NO_UPDATE_CHECK)
         return;
     try {
@@ -180,24 +208,27 @@ export async function initUpdateChecker(deps = {}) {
         const from = safeVersionLabel(installedVersion);
         const to = safeVersionLabel(latest);
         const headline = `Update available: v${from} to v${to}.`;
-        let text;
+        let update;
         if (installKind === "npx-cache") {
             const count = await clearCaches();
-            const cleanup = count > 0
+            update = count > 0
                 ? `Cleared ${count} stale npx cache director${count === 1 ? "y" : "ies"} for ${PACKAGE_NAME} ` +
-                    `(kept the one this server is running from). `
+                    `(kept the one this server is running from).`
                 : "";
-            text = `${headline} ${cleanup}Restart your MCP client to pick up v${to}.`;
         }
         else if (installKind === "source-checkout") {
-            text = `${headline} This server runs from a source checkout, so update that checkout ` +
-                `(git pull, then npm run build) and restart your MCP client. ` +
-                `If it is a fork you maintain, set D2L_NO_UPDATE_CHECK=1 to turn off upstream update notices.`;
+            update = `This server runs from a source checkout, so update that checkout with npm run update ` +
+                `(it pulls, installs dependencies, and rebuilds).`;
         }
         else {
-            text = `${headline} Run: ${GLOBAL_INSTALL_COMMAND}` +
-                `, then ${CLEAR_NPX_CACHE_COMMAND} and restart your MCP client.`;
+            update = `Run: ${GLOBAL_INSTALL_COMMAND}, then ${CLEAR_NPX_CACHE_COMMAND}.`;
         }
+        const optOut = installKind === "source-checkout"
+            ? " If it is a fork you maintain, set D2L_NO_UPDATE_CHECK=1 to turn off upstream update notices."
+            : "";
+        const text = [headline, update, `${reloadStep(installKind, transport, to, update !== "")}${optOut}`]
+            .filter(Boolean)
+            .join(" ");
         // Preserve lastShownAt when the text is unchanged, so a periodic re-check
         // does not reset the throttle and start repeating the same line.
         state = state?.text === text ? state : { text, lastShownAt: null };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brightspace-mcp-server",
-  "version": "5.0.7",
+  "version": "5.0.8",
   "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",