@smithery/sdk 0.0.13 → 0.0.14

package/README.md

@@ -1,6 +1,6 @@
 # Smithery Typescript Framework [![npm version](https://badge.fury.io/js/@smithery%2Fsdk.svg)](https://badge.fury.io/js/@smithery%2Fsdk)
 
-Smithery is a Typescript framework that easily connects language models (LLMs) to [Model Context Protocols](https://modelcontextprotocol.io/) (MCPs), allowing you to build agents that use resources and tools without being overwhelmed by JSON schemas.
+Smithery is a Typescript framework with utilities to make it easier to connect language models (LLMs) to [Model Context Protocols](https://modelcontextprotocol.io/) (MCPs), allowing you to build agents that use resources and tools without being overwhelmed by JSON schemas.
 
 ⚠️ _This repository is work in progress and in alpha. Not recommended for production use yet._ ⚠️
 
@@ -10,6 +10,8 @@ Smithery is a Typescript framework that easily connects language models (LLMs) t
 - Adapters to transform MCP resposnes for OpenAI and Anthropic clients
 - Supports chaining tool calls until LLM completes
 
+To find our registry of MCPs, visit [https://smithery.ai/](https://smithery.ai/).
+
 # Quickstart
 
 ## Installation

package/dist/index.d.ts

@@ -3,7 +3,6 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import type { RequestOptions } from "@modelcontextprotocol/sdk/shared/protocol.js";
 import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
 import { type CallToolRequest, CallToolResultSchema, type CompatibilityCallToolResultSchema, type ListToolsRequest, type Tool } from "@modelcontextprotocol/sdk/types.js";
-export { createRegistryTransport as createTransport, createStdioConfig, fetchRegistryEntry, } from "./registry.js";
 export { OpenAIChatAdapter } from "./integrations/llm/openai.js";
 export { AnthropicChatAdapter } from "./integrations/llm/anthropic.js";
 interface ClientInfo {

package/dist/index.js

@@ -2,7 +2,6 @@ import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { CallToolResultSchema, } from "@modelcontextprotocol/sdk/types.js";
-export { createRegistryTransport as createTransport, createStdioConfig, fetchRegistryEntry, } from "./registry.js";
 export { OpenAIChatAdapter } from "./integrations/llm/openai.js";
 export { AnthropicChatAdapter } from "./integrations/llm/anthropic.js";
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@smithery/sdk",
-	"version": "0.0.13",
+	"version": "0.0.14",
 	"description": "Connect language models to Model Context Protocols",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -17,7 +17,6 @@
 		"build:all": "npm run build -ws --include-workspace-root",
 		"watch": "tsc --watch",
 		"check": "npx @biomejs/biome check --write --unsafe",
-		"bump": "npm version patch -ws --include-workspace-root",
 		"link": "npm link -ws --include-workspace-root"
 	},
 	"license": "GPL-3.0-only",

package/dist/registry-types.d.ts

@@ -1,153 +0,0 @@
-/**
- * Types for entries in the Smithery registry
- */
-import { z } from "zod";
-export declare const JSONSchemaSchema: z.ZodType;
-export type JSONSchema = z.infer<typeof JSONSchemaSchema>;
-export declare const StdioConnectionSchema: z.ZodObject<{
-    command: z.ZodString;
-    args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-}, "strip", z.ZodTypeAny, {
-    command: string;
-    args?: string[] | undefined;
-    env?: Record<string, string> | undefined;
-}, {
-    command: string;
-    args?: string[] | undefined;
-    env?: Record<string, string> | undefined;
-}>;
-export type StdioConnection = z.infer<typeof StdioConnectionSchema>;
-export declare const ConnectionSchema: z.ZodIntersection<z.ZodObject<{
-    configSchema: z.ZodOptional<z.ZodType<any, z.ZodTypeDef, any>>;
-}, "strip", z.ZodTypeAny, {
-    configSchema?: any;
-}, {
-    configSchema?: any;
-}>, z.ZodUnion<[z.ZodObject<{
-    sse: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    sse: string;
-}, {
-    sse: string;
-}>, z.ZodObject<{
-    stdio: z.ZodObject<{
-        command: z.ZodString;
-        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        command: string;
-        args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
-    }, {
-        command: string;
-        args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    stdio: {
-        command: string;
-        args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
-    };
-}, {
-    stdio: {
-        command: string;
-        args?: string[] | undefined;
-        env?: Record<string, string> | undefined;
-    };
-}>]>>;
-export type Connection = z.infer<typeof ConnectionSchema>;
-export declare const RegistryServerSchema: z.ZodObject<{
-    id: z.ZodString;
-    name: z.ZodString;
-    verified: z.ZodOptional<z.ZodBoolean>;
-    description: z.ZodOptional<z.ZodString>;
-    vendor: z.ZodOptional<z.ZodString>;
-    sourceUrl: z.ZodString;
-    license: z.ZodOptional<z.ZodString>;
-    homepage: z.ZodString;
-    connections: z.ZodArray<z.ZodIntersection<z.ZodObject<{
-        configSchema: z.ZodOptional<z.ZodType<any, z.ZodTypeDef, any>>;
-    }, "strip", z.ZodTypeAny, {
-        configSchema?: any;
-    }, {
-        configSchema?: any;
-    }>, z.ZodUnion<[z.ZodObject<{
-        sse: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        sse: string;
-    }, {
-        sse: string;
-    }>, z.ZodObject<{
-        stdio: z.ZodObject<{
-            command: z.ZodString;
-            args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        }, "strip", z.ZodTypeAny, {
-            command: string;
-            args?: string[] | undefined;
-            env?: Record<string, string> | undefined;
-        }, {
-            command: string;
-            args?: string[] | undefined;
-            env?: Record<string, string> | undefined;
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        stdio: {
-            command: string;
-            args?: string[] | undefined;
-            env?: Record<string, string> | undefined;
-        };
-    }, {
-        stdio: {
-            command: string;
-            args?: string[] | undefined;
-            env?: Record<string, string> | undefined;
-        };
-    }>]>>, "many">;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    name: string;
-    sourceUrl: string;
-    homepage: string;
-    connections: ({
-        configSchema?: any;
-    } & ({
-        sse: string;
-    } | {
-        stdio: {
-            command: string;
-            args?: string[] | undefined;
-            env?: Record<string, string> | undefined;
-        };
-    }))[];
-    description?: string | undefined;
-    verified?: boolean | undefined;
-    vendor?: string | undefined;
-    license?: string | undefined;
-}, {
-    id: string;
-    name: string;
-    sourceUrl: string;
-    homepage: string;
-    connections: ({
-        configSchema?: any;
-    } & ({
-        sse: string;
-    } | {
-        stdio: {
-            command: string;
-            args?: string[] | undefined;
-            env?: Record<string, string> | undefined;
-        };
-    }))[];
-    description?: string | undefined;
-    verified?: boolean | undefined;
-    vendor?: string | undefined;
-    license?: string | undefined;
-}>;
-export type RegistryServer = z.infer<typeof RegistryServerSchema>;
-export declare function isStdio(connection: Connection): connection is Connection & {
-    stdio: StdioConnection;
-};

package/dist/registry-types.js

@@ -1,67 +0,0 @@
-/**
- * Types for entries in the Smithery registry
- */
-import { z } from "zod";
-export const JSONSchemaSchema = z
-    .lazy(() => z.object({
-    type: z.string().optional(),
-    properties: z.record(JSONSchemaSchema).optional(),
-    items: JSONSchemaSchema.optional(),
-    required: z.array(z.string()).optional(),
-    description: z.string().optional(),
-    default: z.unknown().optional(),
-}))
-    .describe("JSON Schema defines the configuration required to initialize the server. All variables are used to template fill the commands. Leave undefined if no config required.");
-export const StdioConnectionSchema = z.object({
-    command: z.string().describe("The executable to run to start the server."),
-    args: z
-        .array(z.string())
-        .optional()
-        .describe("Command line arguments to pass to the executable."),
-    env: z
-        .record(z.string(), z.string())
-        .optional()
-        .describe("The environment to use when spawning the process."),
-});
-export const ConnectionSchema = z
-    .object({
-    configSchema: JSONSchemaSchema.optional(),
-})
-    .and(z.union([
-    z.object({
-        sse: z.string().describe("The URL to connect to the server."),
-    }),
-    z.object({
-        stdio: StdioConnectionSchema,
-    }),
-]))
-    .describe("A connection represents the protocol used to connect with the MCP server. A connection can be templated with shell variables in the format of ${VARNAME}. These will be replaced with the actual value of the variable defined in `configSchema` in durnig runtime.");
-export const RegistryServerSchema = z.object({
-    id: z
-        .string()
-        .describe("The unique identifier. Usually the `npm` package name."),
-    name: z.string().describe("The human-readable name of the MCP server."),
-    verified: z
-        .boolean()
-        .optional()
-        .describe("Whether the server is maintained by the official API maintainers."),
-    description: z
-        .string()
-        .optional()
-        .describe("A concise description of the MCP server for end-users."),
-    vendor: z.string().describe("The name of the author of the MCP.").optional(),
-    sourceUrl: z
-        .string()
-        .describe("A URL to the official page of the MCP repository."),
-    license: z.string().optional().describe("The license of the MCP."),
-    homepage: z
-        .string()
-        .describe("The URL to the homepage of the MCP, typically the product page."),
-    connections: z
-        .array(ConnectionSchema)
-        .describe("A list of ways to connect with the MCP server."),
-});
-// Type guard
-export function isStdio(connection) {
-    return "stdio" in connection;
-}

package/dist/registry.d.ts

@@ -1,30 +0,0 @@
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import type { StdioServerParameters } from "@modelcontextprotocol/sdk/client/stdio.js";
-import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
-import { type JSONSchema, type RegistryServer, type StdioConnection } from "./registry-types.js";
-export declare function createStdioConfig(pkg: RegistryServer, variables: JSONSchema): StdioConnection;
-export declare function fetchRegistryEntry(id: string): Promise<RegistryServer>;
-export declare function createRegistryTransport(id: string, variables?: JSONSchema, options?: Partial<StdioServerParameters>): Promise<StdioClientTransport>;
-/**
- * A short cut to create a client that connects to a registry entry and is ready to use
- * @param id ID of the registry entry
- */
-export declare function createRegistryClient(id: string, variables?: JSONSchema, options?: Partial<StdioServerParameters>): Promise<Client<{
-    method: string;
-    params?: import("zod").objectOutputType<{
-        _meta: import("zod").ZodOptional<import("zod").ZodObject<{
-            progressToken: import("zod").ZodOptional<import("zod").ZodUnion<[import("zod").ZodString, import("zod").ZodNumber]>>;
-        }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
-            progressToken: import("zod").ZodOptional<import("zod").ZodUnion<[import("zod").ZodString, import("zod").ZodNumber]>>;
-        }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
-            progressToken: import("zod").ZodOptional<import("zod").ZodUnion<[import("zod").ZodString, import("zod").ZodNumber]>>;
-        }, import("zod").ZodTypeAny, "passthrough">>>;
-    }, import("zod").ZodTypeAny, "passthrough"> | undefined;
-}, {
-    method: string;
-    params?: import("zod").objectOutputType<{
-        _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
-    }, import("zod").ZodTypeAny, "passthrough"> | undefined;
-}, import("zod").objectOutputType<{
-    _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
-}, import("zod").ZodTypeAny, "passthrough">>>;

package/dist/registry.js

@@ -1,66 +0,0 @@
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
-import { REGISTRY_URL } from "./config.js";
-import { isStdio, } from "./registry-types.js";
-// Helper to create StdioClientTransport config
-export function createStdioConfig(pkg, variables) {
-    if (pkg.connections.length === 0) {
-        throw new Error(`No connections defined for package: ${pkg.id}`);
-    }
-    // Use first connection for now - could add connection selection later
-    const connection = pkg.connections[0];
-    if (!isStdio(connection))
-        throw new Error(`Connection not supported for stdio: ${connection}`);
-    const env = {};
-    if (connection.stdio.env) {
-        for (const [key, template] of Object.entries(connection.stdio.env)) {
-            env[key] = template
-                .toString()
-                .replace(/\${([^}]+)}/g, (_, varName) => {
-                if (!(varName in variables)) {
-                    throw new Error(`Missing required variable: ${varName}`);
-                }
-                return variables[varName];
-            });
-        }
-    }
-    return {
-        command: connection.stdio.command,
-        args: connection.stdio.args,
-        env: Object.keys(env).length > 0 ? env : undefined,
-    };
-}
-export async function fetchRegistryEntry(id) {
-    const response = await fetch(`${REGISTRY_URL}/servers/${id}`);
-    if (!response.ok) {
-        throw new Error(`Registry entry not found: ${id}`);
-    }
-    return await response.json();
-}
-export async function createRegistryTransport(id, variables = {}, options = {}) {
-    const pkg = await fetchRegistryEntry(id);
-    const config = createStdioConfig(pkg, variables);
-    const transport = new StdioClientTransport({ ...config, ...options });
-    return transport;
-}
-/**
- * A short cut to create a client that connects to a registry entry and is ready to use
- * @param id ID of the registry entry
- */
-export async function createRegistryClient(id, variables = {}, options = {}) {
-    const transport = await createRegistryTransport(id, variables, options);
-    const client = new Client({
-        name: "mcp-client",
-        version: "1.0.0",
-    }, {
-        capabilities: {},
-    });
-    await client.connect(transport);
-    return client;
-}
-// Example usage:
-/*
-const transport = await createTransport("brave-search", {
-  braveApiKey: "user-api-key"
-})
-*/