@supermodeltools/mcp-server 0.9.1 → 0.9.2

package/dist/index.js

@@ -214,6 +214,13 @@ async function handlePrecache(args) {
     console.error('');
     console.error('Done! To use this cache, set SUPERMODEL_CACHE_DIR=' + outputDir);
 }
+// Graceful shutdown on signals (e.g., container stop, SSH drop)
+for (const signal of ['SIGTERM', 'SIGINT']) {
+    process.on(signal, () => {
+        logger.debug(`Received ${signal}, shutting down`);
+        process.exit(0);
+    });
+}
 main().catch((error) => {
     logger.error('Fatal error:', error);
     process.exit(1);

package/dist/server.js

@@ -167,26 +167,27 @@ Supports partial matching and "ClassName.method" syntax.
                 logger.warn('Failed to load cache directory:', err.message || err);
             }
         }
+        // Connect transport FIRST so the MCP handshake completes immediately.
+        // This prevents Claude Code from timing out the server (MCP_TIMEOUT=60s)
+        // when precaching requires a slow API call.
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this.server.connect(transport);
+        logger.info('Supermodel MCP Server running on stdio');
         // Precache the workdir's repo if --precache flag is set.
-        // Runs BEFORE noApiFallback is set so the API is available.
-        // On first run for a repo this calls the Supermodel API (5-15 min).
-        // The API has server-side idempotency caching, so repeated calls
-        // with the same repo+commit return instantly. Results are saved to
-        // cacheDir for cross-container persistence.
+        // Runs AFTER connect but BEFORE noApiFallback so the API is available.
+        // This is fire-and-forget from the MCP client's perspective — tools
+        // that arrive before precaching finishes will use on-demand API calls.
         if (this.options?.precache && this.defaultWorkdir) {
             try {
                 await (0, graph_cache_1.precacheForDirectory)(this.client, this.defaultWorkdir, cacheDir);
             }
             catch (err) {
-                // Non-fatal: if precaching fails, tools fall back to no-cache error
+                // Non-fatal: if precaching fails, tools fall back to on-demand API
                 logger.warn('Startup precache failed:', err.message || err);
             }
         }
         // NOW enable no-api-fallback (after precaching had its chance)
         (0, graph_cache_1.setNoApiFallback)(!!this.options?.noApiFallback);
-        const transport = new stdio_js_1.StdioServerTransport();
-        await this.server.connect(transport);
-        logger.info('Supermodel MCP Server running on stdio');
     }
 }
 exports.Server = Server;

package/dist/tools/overview.js

@@ -30,7 +30,8 @@ exports.tool = {
     },
 };
 const handler = async (client, args, defaultWorkdir) => {
-    const directory = args?.directory ?? defaultWorkdir;
+    const rawDir = args?.directory;
+    const directory = (rawDir && rawDir.trim()) || defaultWorkdir || process.cwd();
     if (!directory || typeof directory !== 'string') {
         return (0, types_1.asErrorResult)({
             type: 'validation_error',

package/dist/tools/symbol-context.js

@@ -37,7 +37,8 @@ exports.tool = {
 };
 const handler = async (client, args, defaultWorkdir) => {
     const symbol = typeof args?.symbol === 'string' ? args.symbol.trim() : '';
-    const directory = args?.directory ?? defaultWorkdir;
+    const rawDir = args?.directory;
+    const directory = (rawDir && rawDir.trim()) || defaultWorkdir || process.cwd();
     if (!symbol) {
         return (0, types_1.asErrorResult)({
             type: 'validation_error',

package/dist/utils/api-helpers.js

@@ -66,6 +66,16 @@ function classifyApiError(error) {
             details: { errorType: typeof error },
         };
     }
+    // Fast-fail: no pre-computed cache and API fallback disabled
+    if (error.code === 'NO_CACHE') {
+        return {
+            type: 'cache_error',
+            message: error.message || 'No pre-computed graph available for this repository.',
+            code: 'NO_CACHE',
+            recoverable: false,
+            suggestion: 'Use grep, find, and file reading to explore the codebase instead. Or run the precache command and set SUPERMODEL_CACHE_DIR.',
+        };
+    }
     if (error.response) {
         const status = error.response.status;
         switch (status) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supermodeltools/mcp-server",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "description": "MCP server for Supermodel API - code graph generation for AI agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -38,7 +38,7 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.1",
-    "@supermodeltools/sdk": "0.9.1",
+    "@supermodeltools/sdk": "0.9.2",
     "archiver": "^7.0.1",
     "ignore": "^7.0.5",
     "jq-web": "^0.6.2",