@ni-c/mcp-hub 0.7.0 → 0.9.0

package/dist/tool-cache.js

@@ -0,0 +1,86 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+const CACHE_VERSION = 1;
+/**
+ * Persistent per-server snapshots, so on-demand servers can boot straight into
+ * `sleeping` and still answer `initialize` and `tools/list` from cache.
+ *
+ * The entry is keyed to a *hash* of the expanded config rather than the config
+ * itself: the expanded form contains secrets (env values, headers), and a hash
+ * both keeps them out of the data volume and still invalidates the entry when
+ * a referenced ${VAR} rotates.
+ */
+export class ToolCache {
+    filePath;
+    servers = new Map();
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    static fingerprint(config) {
+        return createHash('sha256').update(JSON.stringify(config)).digest('hex');
+    }
+    /** A corrupt or foreign-version file must never take the hub down — it only costs a warm start. */
+    load() {
+        let raw;
+        try {
+            raw = fs.readFileSync(this.filePath, 'utf8');
+        }
+        catch {
+            return; // no cache yet
+        }
+        try {
+            const parsed = JSON.parse(raw);
+            if (parsed.version !== CACHE_VERSION || typeof parsed.servers !== 'object' || parsed.servers === null) {
+                throw new Error(`unsupported cache format (version ${parsed.version})`);
+            }
+            this.servers = new Map(Object.entries(parsed.servers));
+        }
+        catch (error) {
+            console.warn(`mcp-hub: ignoring unreadable tool cache ${this.filePath}: ${error.message}`);
+            this.servers = new Map();
+        }
+    }
+    probeWritable() {
+        const probe = `${this.filePath}.probe`;
+        try {
+            fs.mkdirSync(path.dirname(this.filePath), { recursive: true });
+            fs.writeFileSync(probe, '');
+            fs.unlinkSync(probe);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    get(name, fingerprint) {
+        const entry = this.servers.get(name);
+        if (!entry || entry.fingerprint !== fingerprint)
+            return undefined;
+        return entry;
+    }
+    put(name, entry) {
+        this.servers.set(name, entry);
+        this.flush();
+    }
+    delete(name) {
+        if (!this.servers.delete(name))
+            return;
+        this.flush();
+    }
+    flush() {
+        const file = { version: CACHE_VERSION, servers: Object.fromEntries(this.servers) };
+        const tmp = `${this.filePath}.tmp`;
+        try {
+            fs.mkdirSync(path.dirname(this.filePath), { recursive: true });
+            // Write-then-rename: a crash mid-write leaves the previous cache intact
+            // instead of a truncated file the next boot would have to throw away.
+            fs.writeFileSync(tmp, JSON.stringify(file));
+            fs.renameSync(tmp, this.filePath);
+        }
+        catch (error) {
+            console.warn(`mcp-hub: could not write tool cache ${this.filePath}: ${error.message}`);
+        }
+    }
+}
+//# sourceMappingURL=tool-cache.js.map

package/dist/tool-cache.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ni-c/mcp-hub",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Serve multiple stdio MCP servers from one container: Claude-Code-style mcpServers config, path-based routing, hub meta-tools, and OAuth 2.1 + API tokens for ChatGPT, Claude and any Streamable-HTTP MCP client.",
   "keywords": [
     "mcp",
@@ -27,6 +27,7 @@
   "main": "dist/index.js",
   "bin": {
     "mcp-hub": "dist/index.js",
+    "mcp-hub-stdio": "dist/stdio.js",
     "mcp-hub-admin": "dist/admin.js",
     "mcp-hub-docker-proxy": "dist/docker-proxy/index.js"
   },