@smithery/sdk 1.5.6 → 1.5.8

package/dist/server/stateful.js

@@ -102,7 +102,6 @@ export function createStatefulServer(createMcpServer, options) {
             $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,
         };

package/dist/server/stateless.js

@@ -98,7 +98,6 @@ export function createStatelessServer(createMcpServer, options) {
             $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,
         };

package/dist/shared/config.d.ts

@@ -9,28 +9,17 @@ export interface SmitheryUrlOptions {
  * Creates a URL to connect to the Smithery MCP server.
  * @param baseUrl The base URL of the Smithery server
  * @param options Optional configuration object
- * @returns A URL object with properly encoded parameters. Example: https://server.smithery.ai/{namespace}/mcp?config=BASE64_ENCODED_CONFIG&api_key=API_KEY
+ * @returns A URL with config encoded using dot-notation query params (e.g. model.name=gpt-4&debug=true)
  */
 export declare function createSmitheryUrl(baseUrl: string, options?: SmitheryUrlOptions): URL;
-/**
- * Parses the config from an express request by checking the query parameter "config".
- * @param req The express request
- * @returns The config
- */
-export declare function parseExpressRequestConfig(req: ExpressRequest): Record<string, unknown>;
 /**
  * Parses and validates config from an Express request with optional Zod schema validation
- * Supports both base64-encoded config and dot-notation config parameters
+ * Supports dot-notation config parameters (e.g., foo=bar, a.b=c)
  * @param req The express request
  * @param schema Optional Zod schema for validation
  * @returns Result with either parsed data or error response
  */
 export declare function parseAndValidateConfig<T = Record<string, unknown>>(req: ExpressRequest, schema?: z.ZodSchema<T>): import("okay-error").Err<{
-    title: string;
-    status: number;
-    detail: string;
-    instance: string;
-}> | import("okay-error").Err<{
     readonly title: "Invalid configuration parameters";
     readonly status: 422;
     readonly detail: "One or more config parameters are invalid.";
@@ -48,3 +37,4 @@ export declare function parseAndValidateConfig<T = Record<string, unknown>>(req:
         received: unknown;
     }[];
 }> | import("okay-error").Ok<T>;
+export declare function parseConfigFromQuery(query: Iterable<[string, unknown]>): Record<string, unknown>;

package/dist/shared/config.js

@@ -1,19 +1,54 @@
 import _ from "lodash";
 import { err, ok } from "okay-error";
 import { zodToJsonSchema } from "zod-to-json-schema";
+function isPlainObject(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function appendConfigAsDotParams(url, config) {
+    function add(pathParts, value) {
+        if (Array.isArray(value)) {
+            for (let index = 0; index < value.length; index++) {
+                add([...pathParts, String(index)], value[index]);
+            }
+            return;
+        }
+        if (isPlainObject(value)) {
+            for (const [key, nested] of Object.entries(value)) {
+                add([...pathParts, key], nested);
+            }
+            return;
+        }
+        const key = pathParts.join(".");
+        let stringValue;
+        switch (typeof value) {
+            case "string":
+                stringValue = value;
+                break;
+            case "number":
+            case "boolean":
+                stringValue = String(value);
+                break;
+            default:
+                stringValue = JSON.stringify(value);
+        }
+        url.searchParams.set(key, stringValue);
+    }
+    if (isPlainObject(config)) {
+        for (const [key, value] of Object.entries(config)) {
+            add([key], value);
+        }
+    }
+}
 /**
  * Creates a URL to connect to the Smithery MCP server.
  * @param baseUrl The base URL of the Smithery server
  * @param options Optional configuration object
- * @returns A URL object with properly encoded parameters. Example: https://server.smithery.ai/{namespace}/mcp?config=BASE64_ENCODED_CONFIG&api_key=API_KEY
+ * @returns A URL with config encoded using dot-notation query params (e.g. model.name=gpt-4&debug=true)
  */
 export function createSmitheryUrl(baseUrl, options) {
     const url = new URL(`${baseUrl}/mcp`);
     if (options?.config) {
-        const param = typeof window !== "undefined"
-            ? btoa(JSON.stringify(options.config))
-            : Buffer.from(JSON.stringify(options.config)).toString("base64");
-        url.searchParams.set("config", param);
+        appendConfigAsDotParams(url, options.config);
     }
     if (options?.apiKey) {
         url.searchParams.set("api_key", options.apiKey);
@@ -23,60 +58,15 @@ export function createSmitheryUrl(baseUrl, options) {
     }
     return url;
 }
-/**
- * Parses the config from an express request by checking the query parameter "config".
- * @param req The express request
- * @returns The config
- */
-export function parseExpressRequestConfig(req) {
-    return JSON.parse(Buffer.from(req.query.config, "base64").toString());
-}
 /**
  * Parses and validates config from an Express request with optional Zod schema validation
- * Supports both base64-encoded config and dot-notation config parameters
+ * Supports dot-notation config parameters (e.g., foo=bar, a.b=c)
  * @param req The express request
  * @param schema Optional Zod schema for validation
  * @returns Result with either parsed data or error response
  */
 export function parseAndValidateConfig(req, schema) {
-    // Parse config from request parameters
-    let config = {};
-    // 1. Process base64-encoded config parameter if present
-    if (req.query.config) {
-        try {
-            config = parseExpressRequestConfig(req);
-        }
-        catch (configError) {
-            return err({
-                title: "Invalid config parameter",
-                status: 400,
-                detail: "Failed to parse config parameter",
-                instance: req.originalUrl,
-            });
-        }
-    }
-    // 2. Process dot-notation config parameters (foo=bar, a.b=c)
-    // This allows URL params like ?server.host=localhost&server.port=8080&debug=true
-    for (const [key, value] of Object.entries(req.query)) {
-        // Skip reserved parameters
-        if (key === "config" || key === "api_key" || key === "profile")
-            continue;
-        const pathParts = key.split(".");
-        // Handle array values from Express query parsing
-        const rawValue = Array.isArray(value) ? value[0] : value;
-        if (typeof rawValue !== "string")
-            continue;
-        // Try to parse value as JSON (for booleans, numbers, objects)
-        let parsedValue = rawValue;
-        try {
-            parsedValue = JSON.parse(rawValue);
-        }
-        catch {
-            // If parsing fails, use the raw string value
-        }
-        // Use lodash's set method to handle nested paths
-        _.set(config, pathParts, parsedValue);
-    }
+    const config = parseConfigFromQuery(Object.entries(req.query));
     // Validate config against schema if provided
     if (schema) {
         const result = schema.safeParse(config);
@@ -114,3 +104,29 @@ export function parseAndValidateConfig(req, schema) {
     }
     return ok(config);
 }
+// Process dot-notation config parameters from query parameters (foo=bar, a.b=c)
+// This allows URL params like ?server.host=localhost&server.port=8080&debug=true
+export function parseConfigFromQuery(query) {
+    const config = {};
+    for (const [key, value] of query) {
+        // Skip reserved parameters
+        if (key === "api_key" || key === "profile")
+            continue;
+        const pathParts = key.split(".");
+        // Handle array values from Express query parsing
+        const rawValue = Array.isArray(value) ? value[0] : value;
+        if (typeof rawValue !== "string")
+            continue;
+        // Try to parse value as JSON (for booleans, numbers, objects)
+        let parsedValue = rawValue;
+        try {
+            parsedValue = JSON.parse(rawValue);
+        }
+        catch {
+            // If parsing fails, use the raw string value
+        }
+        // Use lodash's set method to handle nested paths
+        _.set(config, pathParts, parsedValue);
+    }
+    return config;
+}

package/package.json

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