@snokam/mcp-api 0.9.0 → 0.11.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * Snokam MCP Server
+ * Snokam MCP Server — triggers spec refresh on rebuild
  *
  * Exposes Snokam backend APIs as MCP tools by reading bundled OpenAPI specs.
  * Auth is handled via @azure/identity — supports Azure CLI (local),

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * Snokam MCP Server
+ * Snokam MCP Server — triggers spec refresh on rebuild
  *
  * Exposes Snokam backend APIs as MCP tools by reading bundled OpenAPI specs.
  * Auth is handled via @azure/identity — supports Azure CLI (local),
@@ -9,7 +9,7 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { fetchSpecs } from "./openapi-loader.js";
+import { fetchSpecs, fetchSpecFromUrl, } from "./openapi-loader.js";
 import { getAccessToken } from "./auth.js";
 // ---------------------------------------------------------------------------
 // State
@@ -345,6 +345,39 @@ Controls: Sonos speakers, lights, YouTube queue
         if (name === SET_URL_TOOL_NAME) {
             const service = String(args.service ?? "");
             const url = String(args.url ?? "");
+            const isLocal = url.startsWith("http://localhost") ||
+                url.startsWith("http://127.0.0.1");
+            // For localhost URLs, fetch the live swagger spec from the local function
+            // to pick up any new/changed endpoints during development
+            if (isLocal) {
+                try {
+                    const liveEndpoints = await fetchSpecFromUrl(service, url);
+                    // Remove old endpoints for this service
+                    endpoints = endpoints.filter((ep) => ep.service !== service);
+                    // Add the fresh ones
+                    endpoints.push(...liveEndpoints);
+                    // Rebuild lookup map
+                    endpointsByTool = new Map();
+                    for (const ep of endpoints) {
+                        endpointsByTool.set(ep.toolName, ep);
+                    }
+                    serviceUrlOverrides.set(service, url);
+                    await server.sendToolListChanged();
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Overrode ${service} → ${url}. Loaded ${liveEndpoints.length} endpoints from local swagger.`,
+                            },
+                        ],
+                    };
+                }
+                catch (error) {
+                    // Fall through to static override if swagger fetch fails
+                    console.error(`[snokam-mcp] Failed to fetch swagger from ${url}, falling back to static spec:`, error instanceof Error ? error.message : error);
+                }
+            }
+            // Static override: just change the base URL on existing endpoints
             const serviceEndpoints = endpoints.filter((ep) => ep.service === service);
             if (serviceEndpoints.length === 0) {
                 const available = [

package/dist/openapi-loader.d.ts

@@ -42,5 +42,10 @@ interface OpenApiRequestBody {
         schema?: Record<string, unknown>;
     }>;
 }
+/**
+ * Fetch a swagger spec from a specific URL (e.g. a locally running function)
+ * and return parsed endpoints for that service.
+ */
+export declare function fetchSpecFromUrl(service: string, baseUrl: string): Promise<ApiEndpoint[]>;
 export declare function fetchSpecs(environment: string): Promise<ApiEndpoint[]>;
 export {};

package/dist/openapi-loader.js

@@ -101,6 +101,21 @@ function parseSpec(spec, service, baseUrl) {
 // ---------------------------------------------------------------------------
 // Public API
 // ---------------------------------------------------------------------------
+/**
+ * Fetch a swagger spec from a specific URL (e.g. a locally running function)
+ * and return parsed endpoints for that service.
+ */
+export async function fetchSpecFromUrl(service, baseUrl) {
+    const swaggerUrl = `${baseUrl}/swagger.json`;
+    const response = await fetch(swaggerUrl, {
+        signal: AbortSignal.timeout(10_000),
+    });
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status} from ${swaggerUrl}`);
+    }
+    const spec = (await response.json());
+    return parseSpec(spec, service, baseUrl);
+}
 export async function fetchSpecs(environment) {
     // Try to load bundled specs first (for speed)
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snokam/mcp-api",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "MCP server exposing Snokam backend APIs as tools for Claude Code and other MCP clients",
   "type": "module",
   "bin": {