@smithery/sdk 0.0.10 → 0.0.12

package/dist/index.d.ts

@@ -3,7 +3,7 @@ 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 { createTransport, createStdioConfig, fetchRegistryEntry } from "./registry.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,7 @@ 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 { createTransport, createStdioConfig, fetchRegistryEntry } from "./registry.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/dist/registry.d.ts

@@ -1,6 +1,30 @@
+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 createTransport(id: string, variables?: JSONSchema, options?: Partial<StdioServerParameters>): Promise<StdioClientTransport>;
+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,3 +1,4 @@
+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";
@@ -36,12 +37,27 @@ export async function fetchRegistryEntry(id) {
     }
     return await response.json();
 }
-export async function createTransport(id, variables = {}, options = {}) {
+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", {

package/dist/server/builder.d.ts

@@ -0,0 +1,35 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { Prompt, PromptArgument, Resource, Tool, ToolParameters } from "./types.js";
+export declare class ServerBuilder {
+    #private;
+    name: string;
+    version: string;
+    constructor(name?: string, version?: string);
+    private setupHandlers;
+    private setupErrorHandling;
+    private setupToolHandlers;
+    private setupResourceHandlers;
+    private setupPromptHandlers;
+    addTool<Params extends ToolParameters>(tool: Tool<Params>): this;
+    addResource(resource: Resource): this;
+    addPrompt<const Args extends PromptArgument[]>(prompt: Prompt<Args>): this;
+    build(): Server<{
+        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/server/builder.js

@@ -0,0 +1,204 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _ServerBuilder_tools, _ServerBuilder_resources, _ServerBuilder_prompts;
+// Based on https://github.com/wong2/litemcp/
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ErrorCode, GetPromptRequestSchema, ListPromptsRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, McpError, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { zodToJsonSchema } from "zod-to-json-schema";
+export class ServerBuilder {
+    constructor(name = "mcp-server", version = "1.0.0") {
+        this.name = name;
+        this.version = version;
+        _ServerBuilder_tools.set(this, void 0);
+        _ServerBuilder_resources.set(this, void 0);
+        _ServerBuilder_prompts.set(this, void 0);
+        __classPrivateFieldSet(this, _ServerBuilder_tools, [], "f");
+        __classPrivateFieldSet(this, _ServerBuilder_resources, [], "f");
+        __classPrivateFieldSet(this, _ServerBuilder_prompts, [], "f");
+    }
+    setupHandlers(server) {
+        this.setupErrorHandling(server);
+        if (__classPrivateFieldGet(this, _ServerBuilder_tools, "f").length) {
+            this.setupToolHandlers(server);
+        }
+        if (__classPrivateFieldGet(this, _ServerBuilder_resources, "f").length) {
+            this.setupResourceHandlers(server);
+        }
+        if (__classPrivateFieldGet(this, _ServerBuilder_prompts, "f").length) {
+            this.setupPromptHandlers(server);
+        }
+    }
+    setupErrorHandling(server) {
+        server.onerror = (error) => {
+            console.error("[MCP Error]", error);
+        };
+        process.on("SIGINT", async () => {
+            await server.close();
+            process.exit(0);
+        });
+    }
+    setupToolHandlers(server) {
+        server.setRequestHandler(ListToolsRequestSchema, async () => {
+            return {
+                tools: __classPrivateFieldGet(this, _ServerBuilder_tools, "f").map((tool) => {
+                    return {
+                        name: tool.name,
+                        description: tool.description,
+                        inputSchema: tool.parameters
+                            ? zodToJsonSchema(tool.parameters)
+                            : undefined,
+                    };
+                }),
+            };
+        });
+        server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const tool = __classPrivateFieldGet(this, _ServerBuilder_tools, "f").find((tool) => tool.name === request.params.name);
+            if (!tool) {
+                throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${request.params.name}`);
+            }
+            let args = undefined;
+            if (tool.parameters) {
+                const parsed = tool.parameters.safeParse(request.params.arguments);
+                if (!parsed.success) {
+                    throw new McpError(ErrorCode.InvalidRequest, `Invalid ${request.params.name} arguments`);
+                }
+                args = parsed.data;
+            }
+            let result;
+            try {
+                result = await tool.execute(args);
+            }
+            catch (error) {
+                return {
+                    content: [{ type: "text", text: `Error: ${error}` }],
+                    isError: true,
+                };
+            }
+            if (typeof result === "string") {
+                return {
+                    content: [{ type: "text", text: result }],
+                };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        });
+    }
+    setupResourceHandlers(server) {
+        server.setRequestHandler(ListResourcesRequestSchema, async () => {
+            return {
+                resources: __classPrivateFieldGet(this, _ServerBuilder_resources, "f").map((resource) => {
+                    return {
+                        uri: resource.uri,
+                        name: resource.name,
+                        mimeType: resource.mimeType,
+                    };
+                }),
+            };
+        });
+        server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+            const resource = __classPrivateFieldGet(this, _ServerBuilder_resources, "f").find((resource) => resource.uri === request.params.uri);
+            if (!resource) {
+                throw new McpError(ErrorCode.MethodNotFound, `Unknown resource: ${request.params.uri}`);
+            }
+            let result;
+            try {
+                result = await resource.load();
+            }
+            catch (error) {
+                throw new McpError(ErrorCode.InternalError, `Error reading resource: ${error}`, {
+                    uri: resource.uri,
+                });
+            }
+            return {
+                contents: [
+                    {
+                        uri: resource.uri,
+                        mimeType: resource.mimeType,
+                        ...result,
+                    },
+                ],
+            };
+        });
+    }
+    setupPromptHandlers(server) {
+        server.setRequestHandler(ListPromptsRequestSchema, async () => {
+            return {
+                prompts: __classPrivateFieldGet(this, _ServerBuilder_prompts, "f").map((prompt) => {
+                    return {
+                        name: prompt.name,
+                        description: prompt.description,
+                        arguments: prompt.arguments,
+                    };
+                }),
+            };
+        });
+        server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+            const prompt = __classPrivateFieldGet(this, _ServerBuilder_prompts, "f").find((prompt) => prompt.name === request.params.name);
+            if (!prompt) {
+                throw new McpError(ErrorCode.MethodNotFound, `Unknown prompt: ${request.params.name}`);
+            }
+            const args = request.params.arguments;
+            if (prompt.arguments) {
+                for (const arg of prompt.arguments) {
+                    if (arg.required && !(args && arg.name in args)) {
+                        throw new McpError(ErrorCode.InvalidRequest, `Missing required argument: ${arg.name}`);
+                    }
+                }
+            }
+            let result;
+            try {
+                result = await prompt.load(args);
+            }
+            catch (error) {
+                throw new McpError(ErrorCode.InternalError, `Error loading prompt: ${error}`);
+            }
+            return {
+                description: prompt.description,
+                messages: [
+                    {
+                        role: "user",
+                        content: { type: "text", text: result },
+                    },
+                ],
+            };
+        });
+    }
+    addTool(tool) {
+        __classPrivateFieldGet(this, _ServerBuilder_tools, "f").push(tool);
+        return this;
+    }
+    addResource(resource) {
+        __classPrivateFieldGet(this, _ServerBuilder_resources, "f").push(resource);
+        return this;
+    }
+    addPrompt(prompt) {
+        __classPrivateFieldGet(this, _ServerBuilder_prompts, "f").push(prompt);
+        return this;
+    }
+    build() {
+        const capabilities = {};
+        if (__classPrivateFieldGet(this, _ServerBuilder_tools, "f").length) {
+            capabilities.tools = {};
+        }
+        if (__classPrivateFieldGet(this, _ServerBuilder_resources, "f").length) {
+            capabilities.resources = {};
+        }
+        if (__classPrivateFieldGet(this, _ServerBuilder_prompts, "f").length) {
+            capabilities.prompts = {};
+        }
+        const server = new Server({ name: this.name, version: this.version }, { capabilities });
+        this.setupHandlers(server);
+        return server;
+    }
+}
+_ServerBuilder_tools = new WeakMap(), _ServerBuilder_resources = new WeakMap(), _ServerBuilder_prompts = new WeakMap();

package/dist/server/types.d.ts

@@ -0,0 +1,36 @@
+import type { z } from "zod";
+export type ToolParameters = z.ZodTypeAny;
+export interface Tool<Params extends ToolParameters = ToolParameters> {
+    name: string;
+    description?: string;
+    parameters?: Params;
+    execute: (args: z.infer<Params>) => Promise<any>;
+}
+export interface Resource {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+    load: () => Promise<{
+        text: string;
+    } | {
+        blob: string;
+    }>;
+}
+export type PromptArgument = Readonly<{
+    name: string;
+    description?: string;
+    required?: boolean;
+}>;
+type ArgumentsToObject<T extends PromptArgument[]> = {
+    [K in T[number]["name"]]: Extract<T[number], {
+        name: K;
+    }>["required"] extends true ? string : string | undefined;
+};
+export interface Prompt<Arguments extends PromptArgument[] = PromptArgument[], Args = ArgumentsToObject<Arguments>> {
+    name: string;
+    description?: string;
+    arguments?: Arguments;
+    load: (args: Args) => Promise<string>;
+}
+export {};

package/dist/server/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@smithery/sdk",
-	"version": "0.0.10",
+	"version": "0.0.12",
 	"description": "Connect language models to Model Context Protocols",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -16,8 +16,7 @@
 		"build": "tsc",
 		"build:all": "npm run build -ws --include-workspace-root",
 		"watch": "tsc --watch",
-		"lint": "npx @biomejs/biome lint --write",
-		"format": "npx @biomejs/biome format --write",
+		"check": "npx @biomejs/biome check --write --unsafe",
 		"bump": "npm version patch -ws --include-workspace-root",
 		"link": "npm link -ws --include-workspace-root"
 	},