Auto-refresh gists every hour

Author: lostintangent

CHANGELOG.md

@@ -1,3 +1,7 @@
+## 📆 v0.4.6 (06/16/2025)
+
+- The server's gist cache is now automatically refreshed every hour
+
 ## 📆 v0.4.5 (06/16/2025)
 
 - Added the `refresh_gists` tool

README.md

@@ -150,4 +150,4 @@ The `gistpad-mcp` CLI accepts the following optional flags:
 
 ## 🧰 Troubleshooting
 
-- <u>Not seeing a gist in your list?</u> Rhe GistPad MCP server caches your gist list during the lifetime of its server process (for performance reasons), and so if you add/edit/delete a gist externally, you may need to tell GistPad MCP to refresh itself. You can do this by triggering the `refresh_gists` tool (e.g. running `#refresh_gists` in VS Code Copilot chat).
+- <u>Not seeing a gist in your list?</u> The GistPad MCP server caches your gist list and updates it 1) anytime you make a change through the MCP server, or 2) every hour. However, if you add/edit/delete a gist using an external client, you may need to tell GistPad MCP to refresh itself (assuming it hasn't performed its hourly refresh yet). You can do this by triggering the `refresh_gists` tool (e.g. running `#refresh_gists` in VS Code Copilot chat).

package.json

@@ -1,6 +1,6 @@
 {
   "name": "gistpad-mcp",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "An MCP server for managing your personal knowledge, daily notes, and reusable prompts via GitHub Gists.",
   "type": "module",
   "bin": {

src/index.ts

@@ -47,7 +47,7 @@ class GistpadServer {
     this.server = new Server(
       {
         name: "gistpad",
-        version: "0.4.5",
+        version: "0.4.6",
       },
       {
         capabilities: {
@@ -102,6 +102,16 @@ To read gists, notes, and gist comments, prefer using the available resources vs
       await this.server.close();
       process.exit(0);
     });
+
+    // Schedule an hourly background refresh
+    setInterval(async () => {
+      console.error("Refreshing gist cache...");
+
+      await Promise.all([
+        this.gistStore.refresh(),
+        this.starredGistStore.refresh(),
+      ]);
+    }, 1000 * 60 * 60);
   }
 
   private createRequestContext(): RequestContext {

src/store.ts

@@ -40,14 +40,14 @@ export abstract class GistStore {
         }
     }
 
-    private notifyPromptListChanged(): void {
+    private notifyPromptListChanged() {
         if (this.triggerNotifications) {
             this.server.sendPromptListChanged();
         }
     }
 
-    async getAll(): Promise<Gist[]> {
-        if (this.cache === null) {
+    async getAll(forceRefresh: boolean = false): Promise<Gist[]> {
+        if (this.cache === null || forceRefresh) {
             const gists = await this.fetchGists();
             this.cache = this.markdownOnly ? filterGists(gists) : gists;
         }
@@ -66,7 +66,7 @@ export abstract class GistStore {
         }
     }
 
-    remove(gistId: string): void {
+    remove(gistId: string) {
         if (this.cache) {
             this.cache = this.cache.filter((g) => g.id !== gistId);
             this.notifyResourceListChanged();
@@ -94,15 +94,16 @@ export abstract class GistStore {
         }
     }
 
-    invalidate(): void {
-        this.cache = null;
+    async refresh() {
+        await this.getAll(true);
+        this.notifyResourceListChanged();
     }
 
-    subscribe(gistId: string): void {
+    subscribe(gistId: string) {
         this.subscribedGists.add(gistId);
     }
 
-    unsubscribe(gistId: string): void {
+    unsubscribe(gistId: string) {
         this.subscribedGists.delete(gistId);
     }
 

src/tools/refresh.ts

@@ -5,7 +5,7 @@ export default {
         {
             name: "refresh_gists",
             description:
-                "Reload the gist and starred gist stores, bypassing the cache",
+                "Refresh the server's cache of gists, to ensure it picks up any changes made by external clients.",
             inputSchema: {
                 type: "object",
                 properties: {},
@@ -16,15 +16,11 @@ export default {
 
     handlers: {
         refresh_gists: async (_, context) => {
-            context.gistStore.invalidate();
-            context.starredGistStore.invalidate();
-
             await Promise.all([
-                context.gistStore.getAll(),
-                context.starredGistStore.getAll(),
+                context.gistStore.refresh(),
+                context.starredGistStore.refresh(),
             ]);
 
-            await context.server.sendResourceListChanged();
             return "Gists refreshed!";
         },
     },