@smithery/sdk 1.5.4 → 1.5.6

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./shared/config.js";
+export * from "./shared/patch.js";
+export * from "./client/transport.js";
+export * from "./client/integrations/ai-sdk.js";
+export * from "./client/integrations/wrap-error.js";
+export { createStatefulServer, type StatefulServerOptions, } from "./server/stateful.js";
+export * from "./server/session.js";

package/dist/index.js

@@ -0,0 +1,13 @@
+// Smithery SDK – Barrel file
+// Central re-exports so that `dist/index.js` & `index.d.ts` are generated.
+// Update this list whenever a new top-level feature is added.
+// Shared utilities
+export * from "./shared/config.js";
+export * from "./shared/patch.js";
+// Client-side helpers
+export * from "./client/transport.js";
+export * from "./client/integrations/ai-sdk.js";
+export * from "./client/integrations/wrap-error.js";
+// Server-side helpers (selective to avoid duplicate type names)
+export { createStatefulServer, } from "./server/stateful.js";
+export * from "./server/session.js";

package/dist/server/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./stateful.js";
+export * from "./stateless.js";
+export * from "./session.js";

package/dist/server/index.js

@@ -0,0 +1,3 @@
+export * from "./stateful.js";
+export * from "./stateless.js";
+export * from "./session.js";

package/dist/server/stateful.js

@@ -108,8 +108,8 @@ export function createStatefulServer(createMcpServer, options) {
         };
         res.json(configSchema);
     });
-    // Reusable handler for GET and DELETE requests
-    const handleSessionRequest = async (req, res) => {
+    // Handle GET requests for server-to-client notifications via SSE
+    app.get("/mcp", async (req, res) => {
         const sessionId = req.headers["mcp-session-id"];
         if (!sessionId || !sessionStore.get(sessionId)) {
             res.status(400).send("Invalid or expired session ID");
@@ -118,9 +118,7 @@ export function createStatefulServer(createMcpServer, options) {
         // biome-ignore lint/style/noNonNullAssertion: Not possible
         const transport = sessionStore.get(sessionId);
         await transport.handleRequest(req, res);
-    };
-    // Handle GET requests for server-to-client notifications via SSE
-    app.get("/mcp", handleSessionRequest);
+    });
     // Handle DELETE requests for session termination
     // https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#session-management
     app.delete("/mcp", async (req, res) => {

package/dist/server/stateless.d.ts

@@ -0,0 +1,35 @@
+import express from "express";
+import type { z } from "zod";
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+/**
+ * Arguments when we create a stateless server instance
+ */
+export interface CreateStatelessServerArg<T = Record<string, unknown>> {
+    config: T;
+}
+export type CreateStatelessServerFn<T = Record<string, unknown>> = (arg: CreateStatelessServerArg<T>) => Server;
+/**
+ * Configuration options for the stateless server
+ */
+export interface StatelessServerOptions<T = Record<string, unknown>> {
+    /**
+     * Zod schema for config validation
+     */
+    schema?: z.ZodSchema<T>;
+    /**
+     * Express app instance to use (optional)
+     */
+    app?: express.Application;
+}
+/**
+ * Creates a stateless server for handling MCP requests.
+ * Each request creates a new server instance - no session state is maintained.
+ * This is ideal for stateless API integrations and serverless environments.
+ *
+ * @param createMcpServer Function to create an MCP server
+ * @param options Configuration options including optional schema validation and Express app
+ * @returns Express app
+ */
+export declare function createStatelessServer<T = Record<string, unknown>>(createMcpServer: CreateStatelessServerFn<T>, options?: StatelessServerOptions<T>): {
+    app: express.Application;
+};

package/dist/server/stateless.js

@@ -0,0 +1,108 @@
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import express from "express";
+import { parseAndValidateConfig } from "../shared/config.js";
+import { zodToJsonSchema } from "zod-to-json-schema";
+/**
+ * Creates a stateless server for handling MCP requests.
+ * Each request creates a new server instance - no session state is maintained.
+ * This is ideal for stateless API integrations and serverless environments.
+ *
+ * @param createMcpServer Function to create an MCP server
+ * @param options Configuration options including optional schema validation and Express app
+ * @returns Express app
+ */
+export function createStatelessServer(createMcpServer, options) {
+    const app = options?.app ?? express();
+    app.use("/mcp", express.json());
+    // Handle POST requests for client-to-server communication
+    app.post("/mcp", async (req, res) => {
+        // In stateless mode, create a new instance of transport and server for each request
+        // to ensure complete isolation. A single instance would cause request ID collisions
+        // when multiple clients connect concurrently.
+        try {
+            // Validate config for all requests in stateless mode
+            const configResult = parseAndValidateConfig(req, options?.schema);
+            if (!configResult.ok) {
+                const status = configResult.error.status || 400;
+                res.status(status).json(configResult.error);
+                return;
+            }
+            const config = configResult.value;
+            // Create a fresh server instance for each request
+            const server = createMcpServer({
+                config,
+            });
+            // Create a new transport for this request (no session management)
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: undefined,
+            });
+            // Clean up resources when request closes
+            res.on("close", () => {
+                transport.close();
+                server.close();
+            });
+            // Connect to the MCP server
+            await server.connect(transport);
+            // Handle the request directly
+            await transport.handleRequest(req, res, req.body);
+        }
+        catch (error) {
+            console.error("Error handling MCP request:", error);
+            if (!res.headersSent) {
+                res.status(500).json({
+                    jsonrpc: "2.0",
+                    error: {
+                        code: -32603,
+                        message: "Internal server error",
+                    },
+                    id: null,
+                });
+            }
+        }
+    });
+    // SSE notifications not supported in stateless mode
+    app.get("/mcp", async (_req, res) => {
+        res.status(405).json({
+            jsonrpc: "2.0",
+            error: {
+                code: -32000,
+                message: "Method not allowed.",
+            },
+            id: null,
+        });
+    });
+    // Session termination not needed in stateless mode
+    app.delete("/mcp", async (_req, res) => {
+        res.status(405).json({
+            jsonrpc: "2.0",
+            error: {
+                code: -32000,
+                message: "Method not allowed.",
+            },
+            id: null,
+        });
+    });
+    // Add .well-known/mcp-config endpoint for configuration discovery
+    app.get("/.well-known/mcp-config", (req, res) => {
+        // Set proper content type for JSON Schema
+        res.set("Content-Type", "application/schema+json; charset=utf-8");
+        const baseSchema = options?.schema
+            ? zodToJsonSchema(options.schema)
+            : {
+                type: "object",
+                properties: {},
+                required: [],
+            };
+        const configSchema = {
+            $schema: "https://json-schema.org/draft/2020-12/schema",
+            $id: `${req.protocol}://${req.get("host")}/.well-known/mcp-config`,
+            title: "MCP Session Configuration",
+            description: "Schema for the /mcp endpoint configuration",
+            "x-mcp-version": "1.0",
+            "x-query-style": "dot+bracket",
+            ...baseSchema,
+        };
+        res.json(configSchema);
+    });
+    return { app };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@smithery/sdk",
-	"version": "1.5.4",
+	"version": "1.5.6",
 	"description": "SDK to develop with Smithery",
 	"type": "module",
 	"main": "./dist/index.js",