fastmcp 1.4.0 → 1.5.0

package/README.md

@@ -171,6 +171,75 @@ server.addTool({
 });
 ```
 
+#### Returning an image
+
+Use the `imageContent` to create a content object for an image:
+
+```js
+import { imageContent } from "fastmcp";
+
+server.addTool({
+  name: "download",
+  description: "Download a file",
+  parameters: z.object({
+    url: z.string(),
+  }),
+  execute: async (args) => {
+    return imageContent({
+      url: "https://example.com/image.png",
+    });
+
+    // or...
+    // return imageContent({
+    //   path: "/path/to/image.png",
+    // });
+
+    // or...
+    // return imageContent({
+    //   buffer: Buffer.from("iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=", "base64"),
+    // });
+
+    // or...
+    // return {
+    //   content: [
+    //     imageContent()
+    //   ],
+    // };
+  },
+});
+```
+
+The `imageContent` function takes the following options:
+
+- `url`: The URL of the image.
+- `path`: The path to the image file.
+- `buffer`: The image data as a buffer.
+
+Only one of `url`, `path`, or `buffer` must be specified.
+
+The above example is equivalent to:
+
+```js
+server.addTool({
+  name: "download",
+  description: "Download a file",
+  parameters: z.object({
+    url: z.string(),
+  }),
+  execute: async (args) => {
+    return {
+      content: [
+        {
+          type: "image",
+          data: "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",
+          mimeType: "image/png",
+        },
+      ],
+    };
+  },
+});
+```
+
 #### Logging
 
 Tools can log messages to the client using the `log` object in the context object:

package/dist/FastMCP.d.ts

@@ -1,5 +1,12 @@
 import { z } from 'zod';
 
+declare const imageContent: (input: {
+    url: string;
+} | {
+    path: string;
+} | {
+    buffer: Buffer;
+}) => Promise<ImageContent>;
 declare abstract class FastMCPError extends Error {
     constructor(message?: string);
 }
@@ -35,6 +42,40 @@ type Context = {
         warn: (message: string, data?: SerializableValue) => void;
     };
 };
+declare const TextContentZodSchema: z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    /**
+     * The text content of the message.
+     */
+    text: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: "text";
+    text: string;
+}, {
+    type: "text";
+    text: string;
+}>;
+type TextContent = z.infer<typeof TextContentZodSchema>;
+declare const ImageContentZodSchema: z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    /**
+     * The base64-encoded image data.
+     */
+    data: z.ZodString;
+    /**
+     * The MIME type of the image. Different providers may support different image types.
+     */
+    mimeType: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: "image";
+    data: string;
+    mimeType: string;
+}, {
+    type: "image";
+    data: string;
+    mimeType: string;
+}>;
+type ImageContent = z.infer<typeof ImageContentZodSchema>;
 declare const ContentResultZodSchema: z.ZodObject<{
     content: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         type: z.ZodLiteral<"text">;
@@ -70,22 +111,22 @@ declare const ContentResultZodSchema: z.ZodObject<{
     isError: z.ZodOptional<z.ZodBoolean>;
 }, "strict", z.ZodTypeAny, {
     content: ({
-        type: "text";
-        text: string;
-    } | {
         type: "image";
         data: string;
         mimeType: string;
+    } | {
+        type: "text";
+        text: string;
     })[];
     isError?: boolean | undefined;
 }, {
     content: ({
-        type: "text";
-        text: string;
-    } | {
         type: "image";
         data: string;
         mimeType: string;
+    } | {
+        type: "text";
+        text: string;
     })[];
     isError?: boolean | undefined;
 }>;
@@ -94,7 +135,7 @@ type Tool<Params extends ToolParameters = ToolParameters> = {
     name: string;
     description?: string;
     parameters?: Params;
-    execute: (args: z.infer<Params>, context: Context) => Promise<string | ContentResult>;
+    execute: (args: z.infer<Params>, context: Context) => Promise<string | ContentResult | TextContent | ImageContent>;
 };
 type Resource = {
     uri: string;
@@ -156,4 +197,4 @@ declare class FastMCP {
     stop(): Promise<void>;
 }
 
-export { FastMCP, UserError };
+export { FastMCP, UserError, imageContent };

package/dist/FastMCP.js

@@ -16,6 +16,33 @@ import {
 import { zodToJsonSchema } from "zod-to-json-schema";
 import { z } from "zod";
 import http from "http";
+import { readFile } from "fs/promises";
+import { fileTypeFromBuffer } from "file-type";
+var imageContent = async (input) => {
+  let rawData;
+  if ("url" in input) {
+    const response = await fetch(input.url);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch image from URL: ${response.statusText}`);
+    }
+    rawData = Buffer.from(await response.arrayBuffer());
+  } else if ("path" in input) {
+    rawData = await readFile(input.path);
+  } else if ("buffer" in input) {
+    rawData = input.buffer;
+  } else {
+    throw new Error(
+      "Invalid input: Provide a valid 'url', 'path', or 'buffer'"
+    );
+  }
+  const mimeType = await fileTypeFromBuffer(rawData);
+  const base64Data = rawData.toString("base64");
+  return {
+    type: "image",
+    data: base64Data,
+    mimeType: mimeType?.mime ?? "image/png"
+  };
+};
 var FastMCPError = class extends Error {
   constructor(message) {
     super(message);
@@ -112,105 +139,106 @@ var FastMCP = class {
         })
       };
     });
-    server.setRequestHandler(
-      CallToolRequestSchema,
-      async (request, ...extra) => {
-        const tool = this.#tools.find(
-          (tool2) => tool2.name === request.params.name
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+      const tool = this.#tools.find(
+        (tool2) => tool2.name === request.params.name
+      );
+      if (!tool) {
+        throw new McpError(
+          ErrorCode.MethodNotFound,
+          `Unknown tool: ${request.params.name}`
         );
-        if (!tool) {
+      }
+      let args = void 0;
+      if (tool.parameters) {
+        const parsed = tool.parameters.safeParse(request.params.arguments);
+        if (!parsed.success) {
           throw new McpError(
-            ErrorCode.MethodNotFound,
-            `Unknown tool: ${request.params.name}`
+            ErrorCode.InvalidRequest,
+            `Invalid ${request.params.name} arguments`
           );
         }
-        let args = void 0;
-        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;
-        }
-        const progressToken = request.params?._meta?.progressToken;
-        let result;
-        try {
-          const reportProgress = async (progress) => {
-            await server.notification({
-              method: "notifications/progress",
-              params: {
-                ...progress,
-                progressToken
-              }
-            });
-          };
-          const log = {
-            debug: (message, context) => {
-              server.sendLoggingMessage({
-                level: "debug",
-                data: {
-                  message,
-                  context
-                }
-              });
-            },
-            error: (message, context) => {
-              server.sendLoggingMessage({
-                level: "error",
-                data: {
-                  message,
-                  context
-                }
-              });
-            },
-            info: (message, context) => {
-              server.sendLoggingMessage({
-                level: "info",
-                data: {
-                  message,
-                  context
-                }
-              });
-            },
-            warn: (message, context) => {
-              server.sendLoggingMessage({
-                level: "warning",
-                data: {
-                  message,
-                  context
-                }
-              });
+        args = parsed.data;
+      }
+      const progressToken = request.params?._meta?.progressToken;
+      let result;
+      try {
+        const reportProgress = async (progress) => {
+          await server.notification({
+            method: "notifications/progress",
+            params: {
+              ...progress,
+              progressToken
             }
-          };
-          const maybeStringResult = await tool.execute(args, {
-            reportProgress,
-            log
           });
-          if (typeof maybeStringResult === "string") {
-            result = ContentResultZodSchema.parse({
-              content: [{ type: "text", text: maybeStringResult }]
+        };
+        const log = {
+          debug: (message, context) => {
+            server.sendLoggingMessage({
+              level: "debug",
+              data: {
+                message,
+                context
+              }
+            });
+          },
+          error: (message, context) => {
+            server.sendLoggingMessage({
+              level: "error",
+              data: {
+                message,
+                context
+              }
+            });
+          },
+          info: (message, context) => {
+            server.sendLoggingMessage({
+              level: "info",
+              data: {
+                message,
+                context
+              }
+            });
+          },
+          warn: (message, context) => {
+            server.sendLoggingMessage({
+              level: "warning",
+              data: {
+                message,
+                context
+              }
             });
-          } else {
-            result = ContentResultZodSchema.parse(maybeStringResult);
-          }
-        } catch (error) {
-          if (error instanceof UserError) {
-            return {
-              content: [{ type: "text", text: error.message }],
-              isError: true
-            };
           }
+        };
+        const maybeStringResult = await tool.execute(args, {
+          reportProgress,
+          log
+        });
+        if (typeof maybeStringResult === "string") {
+          result = ContentResultZodSchema.parse({
+            content: [{ type: "text", text: maybeStringResult }]
+          });
+        } else if ("type" in maybeStringResult) {
+          result = ContentResultZodSchema.parse({
+            content: [maybeStringResult]
+          });
+        } else {
+          result = ContentResultZodSchema.parse(maybeStringResult);
+        }
+      } catch (error) {
+        if (error instanceof UserError) {
           return {
-            content: [{ type: "text", text: `Error: ${error}` }],
+            content: [{ type: "text", text: error.message }],
             isError: true
           };
         }
-        return result;
+        return {
+          content: [{ type: "text", text: `Error: ${error}` }],
+          isError: true
+        };
       }
-    );
+      return result;
+    });
   }
   setupResourceHandlers(server) {
     server.setRequestHandler(ListResourcesRequestSchema, async () => {
@@ -427,6 +455,7 @@ var FastMCP = class {
 };
 export {
   FastMCP,
-  UserError
+  UserError,
+  imageContent
 };
 //# sourceMappingURL=FastMCP.js.map

package/dist/FastMCP.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/FastMCP.ts"],"sourcesContent":["import { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { SSEServerTransport } from \"@modelcontextprotocol/sdk/server/sse.js\";\nimport {\n  CallToolRequestSchema,\n  ErrorCode,\n  GetPromptRequestSchema,\n  ListPromptsRequestSchema,\n  ListResourcesRequestSchema,\n  ListToolsRequestSchema,\n  LoggingLevel,\n  McpError,\n  ReadResourceRequestSchema,\n  ServerCapabilities,\n  SetLevelRequestSchema,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport { z } from \"zod\";\nimport http from \"http\";\n\nabstract class FastMCPError extends Error {\n  public constructor(message?: string) {\n    super(message);\n    this.name = new.target.name;\n  }\n}\n\ntype Extra = unknown;\n\ntype Extras = Record<string, Extra>;\n\nclass UnexpectedStateError extends FastMCPError {\n  public extras?: Extras;\n\n  public constructor(message: string, extras?: Extras) {\n    super(message);\n    this.name = new.target.name;\n    this.extras = extras;\n  }\n}\n\nexport class UserError extends UnexpectedStateError {}\n\ntype ToolParameters = z.ZodTypeAny;\n\ntype Literal = boolean | null | number | string | undefined;\n\ntype SerializableValue =\n  | Literal\n  | SerializableValue[]\n  | { [key: string]: SerializableValue };\n\ntype Progress = {\n  /**\n   * The progress thus far. This should increase every time progress is made, even if the total is unknown.\n   */\n  progress: number;\n  /**\n   * Total number of items to process (or total progress required), if known.\n   */\n  total?: number;\n};\n\ntype Context = {\n  reportProgress: (progress: Progress) => Promise<void>;\n  log: {\n    debug: (message: string, data?: SerializableValue) => void;\n    error: (message: string, data?: SerializableValue) => void;\n    info: (message: string, data?: SerializableValue) => void;\n    warn: (message: string, data?: SerializableValue) => void;\n  };\n};\n\nconst TextContentZodSchema = z\n  .object({\n    type: z.literal(\"text\"),\n    /**\n     * The text content of the message.\n     */\n    text: z.string(),\n  })\n  .strict();\n\ntype TextContent = z.infer<typeof TextContentZodSchema>;\n\nconst ImageContentZodSchema = z\n  .object({\n    type: z.literal(\"image\"),\n    /**\n     * The base64-encoded image data.\n     */\n    data: z.string().base64(),\n    /**\n     * The MIME type of the image. Different providers may support different image types.\n     */\n    mimeType: z.string(),\n  })\n  .strict();\n\ntype ImageContent = z.infer<typeof ImageContentZodSchema>;\n\nconst ContentZodSchema = z.discriminatedUnion(\"type\", [\n  TextContentZodSchema,\n  ImageContentZodSchema,\n]);\n\nconst ContentResultZodSchema = z\n  .object({\n    content: ContentZodSchema.array(),\n    isError: z.boolean().optional(),\n  })\n  .strict();\n\ntype ContentResult = z.infer<typeof ContentResultZodSchema>;\n\ntype Tool<Params extends ToolParameters = ToolParameters> = {\n  name: string;\n  description?: string;\n  parameters?: Params;\n  execute: (\n    args: z.infer<Params>,\n    context: Context,\n  ) => Promise<string | ContentResult>;\n};\n\ntype Resource = {\n  uri: string;\n  name: string;\n  description?: string;\n  mimeType?: string;\n  load: () => Promise<{ text: string } | { blob: string }>;\n};\n\ntype PromptArgument = Readonly<{\n  name: string;\n  description?: string;\n  required?: boolean;\n}>;\n\ntype ArgumentsToObject<T extends PromptArgument[]> = {\n  [K in T[number][\"name\"]]: Extract<\n    T[number],\n    { name: K }\n  >[\"required\"] extends true\n    ? string\n    : string | undefined;\n};\n\ntype Prompt<\n  Arguments extends PromptArgument[] = PromptArgument[],\n  Args = ArgumentsToObject<Arguments>,\n> = {\n  name: string;\n  description?: string;\n  arguments?: Arguments;\n  load: (args: Args) => Promise<string>;\n};\n\ntype ServerOptions = {\n  name: string;\n  version: `${number}.${number}.${number}`;\n};\n\nexport class FastMCP {\n  #tools: Tool[];\n  #resources: Resource[];\n  #prompts: Prompt[];\n  #server: Server | null = null;\n  #options: ServerOptions;\n  #loggingLevel: LoggingLevel = \"info\";\n\n  constructor(public options: ServerOptions) {\n    this.#options = options;\n    this.#tools = [];\n    this.#resources = [];\n    this.#prompts = [];\n  }\n\n  private setupHandlers(server: Server) {\n    this.setupErrorHandling(server);\n\n    if (this.#tools.length) {\n      this.setupToolHandlers(server);\n    }\n\n    if (this.#resources.length) {\n      this.setupResourceHandlers(server);\n    }\n\n    if (this.#prompts.length) {\n      this.setupPromptHandlers(server);\n    }\n\n    server.setRequestHandler(SetLevelRequestSchema, (request) => {\n      this.#loggingLevel = request.params.level;\n\n      return {};\n    });\n  }\n\n  private setupErrorHandling(server: Server) {\n    server.onerror = (error) => {\n      console.error(\"[MCP Error]\", error);\n    };\n    process.on(\"SIGINT\", async () => {\n      await server.close();\n      process.exit(0);\n    });\n  }\n\n  public get loggingLevel() {\n    return this.#loggingLevel;\n  }\n\n  private setupToolHandlers(server: Server) {\n    server.setRequestHandler(ListToolsRequestSchema, async () => {\n      return {\n        tools: this.#tools.map((tool) => {\n          return {\n            name: tool.name,\n            description: tool.description,\n            inputSchema: tool.parameters\n              ? zodToJsonSchema(tool.parameters)\n              : undefined,\n          };\n        }),\n      };\n    });\n\n    server.setRequestHandler(\n      CallToolRequestSchema,\n      async (request, ...extra) => {\n        const tool = this.#tools.find(\n          (tool) => tool.name === request.params.name,\n        );\n\n        if (!tool) {\n          throw new McpError(\n            ErrorCode.MethodNotFound,\n            `Unknown tool: ${request.params.name}`,\n          );\n        }\n\n        let args: any = undefined;\n\n        if (tool.parameters) {\n          const parsed = tool.parameters.safeParse(request.params.arguments);\n\n          if (!parsed.success) {\n            throw new McpError(\n              ErrorCode.InvalidRequest,\n              `Invalid ${request.params.name} arguments`,\n            );\n          }\n\n          args = parsed.data;\n        }\n\n        const progressToken = request.params?._meta?.progressToken;\n\n        let result: ContentResult;\n\n        try {\n          const reportProgress = async (progress: Progress) => {\n            await server.notification({\n              method: \"notifications/progress\",\n              params: {\n                ...progress,\n                progressToken,\n              },\n            });\n          };\n\n          const log = {\n            debug: (message: string, context?: SerializableValue) => {\n              server.sendLoggingMessage({\n                level: \"debug\",\n                data: {\n                  message,\n                  context,\n                },\n              });\n            },\n            error: (message: string, context?: SerializableValue) => {\n              server.sendLoggingMessage({\n                level: \"error\",\n                data: {\n                  message,\n                  context,\n                },\n              });\n            },\n            info: (message: string, context?: SerializableValue) => {\n              server.sendLoggingMessage({\n                level: \"info\",\n                data: {\n                  message,\n                  context,\n                },\n              });\n            },\n            warn: (message: string, context?: SerializableValue) => {\n              server.sendLoggingMessage({\n                level: \"warning\",\n                data: {\n                  message,\n                  context,\n                },\n              });\n            },\n          };\n\n          const maybeStringResult = await tool.execute(args, {\n            reportProgress,\n            log,\n          });\n\n          if (typeof maybeStringResult === \"string\") {\n            result = ContentResultZodSchema.parse({\n              content: [{ type: \"text\", text: maybeStringResult }],\n            });\n          } else {\n            result = ContentResultZodSchema.parse(maybeStringResult);\n          }\n        } catch (error) {\n          if (error instanceof UserError) {\n            return {\n              content: [{ type: \"text\", text: error.message }],\n              isError: true,\n            };\n          }\n\n          return {\n            content: [{ type: \"text\", text: `Error: ${error}` }],\n            isError: true,\n          };\n        }\n\n        return result;\n      },\n    );\n  }\n\n  private setupResourceHandlers(server: Server) {\n    server.setRequestHandler(ListResourcesRequestSchema, async () => {\n      return {\n        resources: this.#resources.map((resource) => {\n          return {\n            uri: resource.uri,\n            name: resource.name,\n            mimeType: resource.mimeType,\n          };\n        }),\n      };\n    });\n\n    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {\n      const resource = this.#resources.find(\n        (resource) => resource.uri === request.params.uri,\n      );\n\n      if (!resource) {\n        throw new McpError(\n          ErrorCode.MethodNotFound,\n          `Unknown resource: ${request.params.uri}`,\n        );\n      }\n\n      let result: Awaited<ReturnType<Resource[\"load\"]>>;\n\n      try {\n        result = await resource.load();\n      } catch (error) {\n        throw new McpError(\n          ErrorCode.InternalError,\n          `Error reading resource: ${error}`,\n          {\n            uri: resource.uri,\n          },\n        );\n      }\n\n      return {\n        contents: [\n          {\n            uri: resource.uri,\n            mimeType: resource.mimeType,\n            ...result,\n          },\n        ],\n      };\n    });\n  }\n\n  private setupPromptHandlers(server: Server) {\n    server.setRequestHandler(ListPromptsRequestSchema, async () => {\n      return {\n        prompts: this.#prompts.map((prompt) => {\n          return {\n            name: prompt.name,\n            description: prompt.description,\n            arguments: prompt.arguments,\n          };\n        }),\n      };\n    });\n\n    server.setRequestHandler(GetPromptRequestSchema, async (request) => {\n      const prompt = this.#prompts.find(\n        (prompt) => prompt.name === request.params.name,\n      );\n\n      if (!prompt) {\n        throw new McpError(\n          ErrorCode.MethodNotFound,\n          `Unknown prompt: ${request.params.name}`,\n        );\n      }\n\n      const args = request.params.arguments;\n\n      if (prompt.arguments) {\n        for (const arg of prompt.arguments) {\n          if (arg.required && !(args && arg.name in args)) {\n            throw new McpError(\n              ErrorCode.InvalidRequest,\n              `Missing required argument: ${arg.name}`,\n            );\n          }\n        }\n      }\n\n      let result: Awaited<ReturnType<Prompt[\"load\"]>>;\n\n      try {\n        result = await prompt.load(args as Record<string, string | undefined>);\n      } catch (error) {\n        throw new McpError(\n          ErrorCode.InternalError,\n          `Error loading prompt: ${error}`,\n        );\n      }\n\n      return {\n        description: prompt.description,\n        messages: [\n          {\n            role: \"user\",\n            content: { type: \"text\", text: result },\n          },\n        ],\n      };\n    });\n  }\n\n  public addTool<Params extends ToolParameters>(tool: Tool<Params>) {\n    this.#tools.push(tool as unknown as Tool);\n  }\n\n  public addResource(resource: Resource) {\n    this.#resources.push(resource);\n  }\n\n  public addPrompt<const Args extends PromptArgument[]>(prompt: Prompt<Args>) {\n    this.#prompts.push(prompt);\n  }\n\n  #httpServer: http.Server | null = null;\n\n  public async start(\n    options:\n      | { transportType: \"stdio\" }\n      | {\n          transportType: \"sse\";\n          sse: { endpoint: `/${string}`; port: number };\n        } = {\n      transportType: \"stdio\",\n    },\n  ) {\n    const capabilities: ServerCapabilities = {};\n\n    if (this.#tools.length) {\n      capabilities.tools = {};\n    }\n\n    if (this.#resources.length) {\n      capabilities.resources = {};\n    }\n\n    if (this.#prompts.length) {\n      capabilities.prompts = {};\n    }\n\n    capabilities.logging = {};\n\n    this.#server = new Server(\n      { name: this.#options.name, version: this.#options.version },\n      { capabilities },\n    );\n\n    this.setupHandlers(this.#server);\n\n    if (options.transportType === \"stdio\") {\n      const transport = new StdioServerTransport();\n\n      await this.#server.connect(transport);\n\n      console.error(`server is running on stdio`);\n    } else if (options.transportType === \"sse\") {\n      let activeTransport: SSEServerTransport | null = null;\n\n      /**\n       * Adopted from https://dev.classmethod.jp/articles/mcp-sse/\n       */\n      this.#httpServer = http.createServer(async (req, res) => {\n        if (req.method === \"GET\" && req.url === options.sse.endpoint) {\n          const transport = new SSEServerTransport(\"/messages\", res);\n\n          activeTransport = transport;\n\n          if (!this.#server) {\n            throw new Error(\"Server not initialized\");\n          }\n\n          await this.#server.connect(transport);\n\n          res.on(\"close\", () => {\n            console.log(\"SSE connection closed\");\n            if (activeTransport === transport) {\n              activeTransport = null;\n            }\n          });\n\n          this.startSending(transport);\n          return;\n        }\n\n        if (req.method === \"POST\" && req.url?.startsWith(\"/messages\")) {\n          if (!activeTransport) {\n            res.writeHead(400).end(\"No active transport\");\n            return;\n          }\n          await activeTransport.handlePostMessage(req, res);\n          return;\n        }\n\n        res.writeHead(404).end();\n      });\n\n      this.#httpServer.listen(options.sse.port, \"0.0.0.0\");\n\n      console.error(\n        `server is running on SSE at http://localhost:${options.sse.port}${options.sse.endpoint}`,\n      );\n    } else {\n      throw new Error(\"Invalid transport type\");\n    }\n  }\n\n  /**\n   * @see https://dev.classmethod.jp/articles/mcp-sse/\n   */\n  private async startSending(transport: SSEServerTransport) {\n    try {\n      await transport.send({\n        jsonrpc: \"2.0\",\n        method: \"sse/connection\",\n        params: { message: \"SSE Connection established\" },\n      });\n\n      let messageCount = 0;\n      const interval = setInterval(async () => {\n        messageCount++;\n\n        const message = `Message ${messageCount} at ${new Date().toISOString()}`;\n\n        try {\n          await transport.send({\n            jsonrpc: \"2.0\",\n            method: \"sse/message\",\n            params: { data: message },\n          });\n\n          console.log(`Sent: ${message}`);\n\n          if (messageCount === 10) {\n            clearInterval(interval);\n\n            await transport.send({\n              jsonrpc: \"2.0\",\n              method: \"sse/complete\",\n              params: { message: \"Stream completed\" },\n            });\n            console.log(\"Stream completed\");\n          }\n        } catch (error) {\n          console.error(\"Error sending message:\", error);\n          clearInterval(interval);\n        }\n      }, 1000);\n    } catch (error) {\n      console.error(\"Error in startSending:\", error);\n    }\n  }\n\n  public async stop() {\n    if (this.#httpServer) {\n      this.#httpServer.close();\n    }\n  }\n}\n"],"mappings":"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","names":["tool","resource","prompt"]}
+{"version":3,"sources":["../src/FastMCP.ts"],"sourcesContent":["import { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { SSEServerTransport } from \"@modelcontextprotocol/sdk/server/sse.js\";\nimport {\n  CallToolRequestSchema,\n  ErrorCode,\n  GetPromptRequestSchema,\n  ListPromptsRequestSchema,\n  ListResourcesRequestSchema,\n  ListToolsRequestSchema,\n  LoggingLevel,\n  McpError,\n  ReadResourceRequestSchema,\n  ServerCapabilities,\n  SetLevelRequestSchema,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport { z } from \"zod\";\nimport http from \"http\";\nimport { readFile } from \"fs/promises\";\nimport { fileTypeFromBuffer } from \"file-type\";\n\nexport const imageContent = async (\n  input: { url: string } | { path: string } | { buffer: Buffer },\n): Promise<ImageContent> => {\n  let rawData: Buffer;\n\n  if (\"url\" in input) {\n    const response = await fetch(input.url);\n\n    if (!response.ok) {\n      throw new Error(`Failed to fetch image from URL: ${response.statusText}`);\n    }\n\n    rawData = Buffer.from(await response.arrayBuffer());\n  } else if (\"path\" in input) {\n    rawData = await readFile(input.path);\n  } else if (\"buffer\" in input) {\n    rawData = input.buffer;\n  } else {\n    throw new Error(\n      \"Invalid input: Provide a valid 'url', 'path', or 'buffer'\",\n    );\n  }\n\n  const mimeType = await fileTypeFromBuffer(rawData);\n\n  const base64Data = rawData.toString(\"base64\");\n\n  return {\n    type: \"image\",\n    data: base64Data,\n    mimeType: mimeType?.mime ?? \"image/png\",\n  } as const;\n};\n\nabstract class FastMCPError extends Error {\n  public constructor(message?: string) {\n    super(message);\n    this.name = new.target.name;\n  }\n}\n\ntype Extra = unknown;\n\ntype Extras = Record<string, Extra>;\n\nclass UnexpectedStateError extends FastMCPError {\n  public extras?: Extras;\n\n  public constructor(message: string, extras?: Extras) {\n    super(message);\n    this.name = new.target.name;\n    this.extras = extras;\n  }\n}\n\nexport class UserError extends UnexpectedStateError {}\n\ntype ToolParameters = z.ZodTypeAny;\n\ntype Literal = boolean | null | number | string | undefined;\n\ntype SerializableValue =\n  | Literal\n  | SerializableValue[]\n  | { [key: string]: SerializableValue };\n\ntype Progress = {\n  /**\n   * The progress thus far. This should increase every time progress is made, even if the total is unknown.\n   */\n  progress: number;\n  /**\n   * Total number of items to process (or total progress required), if known.\n   */\n  total?: number;\n};\n\ntype Context = {\n  reportProgress: (progress: Progress) => Promise<void>;\n  log: {\n    debug: (message: string, data?: SerializableValue) => void;\n    error: (message: string, data?: SerializableValue) => void;\n    info: (message: string, data?: SerializableValue) => void;\n    warn: (message: string, data?: SerializableValue) => void;\n  };\n};\n\nconst TextContentZodSchema = z\n  .object({\n    type: z.literal(\"text\"),\n    /**\n     * The text content of the message.\n     */\n    text: z.string(),\n  })\n  .strict();\n\ntype TextContent = z.infer<typeof TextContentZodSchema>;\n\nconst ImageContentZodSchema = z\n  .object({\n    type: z.literal(\"image\"),\n    /**\n     * The base64-encoded image data.\n     */\n    data: z.string().base64(),\n    /**\n     * The MIME type of the image. Different providers may support different image types.\n     */\n    mimeType: z.string(),\n  })\n  .strict();\n\ntype ImageContent = z.infer<typeof ImageContentZodSchema>;\n\nconst ContentZodSchema = z.discriminatedUnion(\"type\", [\n  TextContentZodSchema,\n  ImageContentZodSchema,\n]);\n\nconst ContentResultZodSchema = z\n  .object({\n    content: ContentZodSchema.array(),\n    isError: z.boolean().optional(),\n  })\n  .strict();\n\ntype ContentResult = z.infer<typeof ContentResultZodSchema>;\n\ntype Tool<Params extends ToolParameters = ToolParameters> = {\n  name: string;\n  description?: string;\n  parameters?: Params;\n  execute: (\n    args: z.infer<Params>,\n    context: Context,\n  ) => Promise<string | ContentResult | TextContent | ImageContent>;\n};\n\ntype Resource = {\n  uri: string;\n  name: string;\n  description?: string;\n  mimeType?: string;\n  load: () => Promise<{ text: string } | { blob: string }>;\n};\n\ntype PromptArgument = Readonly<{\n  name: string;\n  description?: string;\n  required?: boolean;\n}>;\n\ntype ArgumentsToObject<T extends PromptArgument[]> = {\n  [K in T[number][\"name\"]]: Extract<\n    T[number],\n    { name: K }\n  >[\"required\"] extends true\n    ? string\n    : string | undefined;\n};\n\ntype Prompt<\n  Arguments extends PromptArgument[] = PromptArgument[],\n  Args = ArgumentsToObject<Arguments>,\n> = {\n  name: string;\n  description?: string;\n  arguments?: Arguments;\n  load: (args: Args) => Promise<string>;\n};\n\ntype ServerOptions = {\n  name: string;\n  version: `${number}.${number}.${number}`;\n};\n\nexport class FastMCP {\n  #tools: Tool[];\n  #resources: Resource[];\n  #prompts: Prompt[];\n  #server: Server | null = null;\n  #options: ServerOptions;\n  #loggingLevel: LoggingLevel = \"info\";\n\n  constructor(public options: ServerOptions) {\n    this.#options = options;\n    this.#tools = [];\n    this.#resources = [];\n    this.#prompts = [];\n  }\n\n  private setupHandlers(server: Server) {\n    this.setupErrorHandling(server);\n\n    if (this.#tools.length) {\n      this.setupToolHandlers(server);\n    }\n\n    if (this.#resources.length) {\n      this.setupResourceHandlers(server);\n    }\n\n    if (this.#prompts.length) {\n      this.setupPromptHandlers(server);\n    }\n\n    server.setRequestHandler(SetLevelRequestSchema, (request) => {\n      this.#loggingLevel = request.params.level;\n\n      return {};\n    });\n  }\n\n  private setupErrorHandling(server: Server) {\n    server.onerror = (error) => {\n      console.error(\"[MCP Error]\", error);\n    };\n    process.on(\"SIGINT\", async () => {\n      await server.close();\n      process.exit(0);\n    });\n  }\n\n  public get loggingLevel() {\n    return this.#loggingLevel;\n  }\n\n  private setupToolHandlers(server: Server) {\n    server.setRequestHandler(ListToolsRequestSchema, async () => {\n      return {\n        tools: this.#tools.map((tool) => {\n          return {\n            name: tool.name,\n            description: tool.description,\n            inputSchema: tool.parameters\n              ? zodToJsonSchema(tool.parameters)\n              : undefined,\n          };\n        }),\n      };\n    });\n\n    server.setRequestHandler(CallToolRequestSchema, async (request) => {\n      const tool = this.#tools.find(\n        (tool) => tool.name === request.params.name,\n      );\n\n      if (!tool) {\n        throw new McpError(\n          ErrorCode.MethodNotFound,\n          `Unknown tool: ${request.params.name}`,\n        );\n      }\n\n      let args: any = undefined;\n\n      if (tool.parameters) {\n        const parsed = tool.parameters.safeParse(request.params.arguments);\n\n        if (!parsed.success) {\n          throw new McpError(\n            ErrorCode.InvalidRequest,\n            `Invalid ${request.params.name} arguments`,\n          );\n        }\n\n        args = parsed.data;\n      }\n\n      const progressToken = request.params?._meta?.progressToken;\n\n      let result: ContentResult;\n\n      try {\n        const reportProgress = async (progress: Progress) => {\n          await server.notification({\n            method: \"notifications/progress\",\n            params: {\n              ...progress,\n              progressToken,\n            },\n          });\n        };\n\n        const log = {\n          debug: (message: string, context?: SerializableValue) => {\n            server.sendLoggingMessage({\n              level: \"debug\",\n              data: {\n                message,\n                context,\n              },\n            });\n          },\n          error: (message: string, context?: SerializableValue) => {\n            server.sendLoggingMessage({\n              level: \"error\",\n              data: {\n                message,\n                context,\n              },\n            });\n          },\n          info: (message: string, context?: SerializableValue) => {\n            server.sendLoggingMessage({\n              level: \"info\",\n              data: {\n                message,\n                context,\n              },\n            });\n          },\n          warn: (message: string, context?: SerializableValue) => {\n            server.sendLoggingMessage({\n              level: \"warning\",\n              data: {\n                message,\n                context,\n              },\n            });\n          },\n        };\n\n        const maybeStringResult = await tool.execute(args, {\n          reportProgress,\n          log,\n        });\n\n        if (typeof maybeStringResult === \"string\") {\n          result = ContentResultZodSchema.parse({\n            content: [{ type: \"text\", text: maybeStringResult }],\n          });\n        } else if (\"type\" in maybeStringResult) {\n          result = ContentResultZodSchema.parse({\n            content: [maybeStringResult],\n          });\n        } else {\n          result = ContentResultZodSchema.parse(maybeStringResult);\n        }\n      } catch (error) {\n        if (error instanceof UserError) {\n          return {\n            content: [{ type: \"text\", text: error.message }],\n            isError: true,\n          };\n        }\n\n        return {\n          content: [{ type: \"text\", text: `Error: ${error}` }],\n          isError: true,\n        };\n      }\n\n      return result;\n    });\n  }\n\n  private setupResourceHandlers(server: Server) {\n    server.setRequestHandler(ListResourcesRequestSchema, async () => {\n      return {\n        resources: this.#resources.map((resource) => {\n          return {\n            uri: resource.uri,\n            name: resource.name,\n            mimeType: resource.mimeType,\n          };\n        }),\n      };\n    });\n\n    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {\n      const resource = this.#resources.find(\n        (resource) => resource.uri === request.params.uri,\n      );\n\n      if (!resource) {\n        throw new McpError(\n          ErrorCode.MethodNotFound,\n          `Unknown resource: ${request.params.uri}`,\n        );\n      }\n\n      let result: Awaited<ReturnType<Resource[\"load\"]>>;\n\n      try {\n        result = await resource.load();\n      } catch (error) {\n        throw new McpError(\n          ErrorCode.InternalError,\n          `Error reading resource: ${error}`,\n          {\n            uri: resource.uri,\n          },\n        );\n      }\n\n      return {\n        contents: [\n          {\n            uri: resource.uri,\n            mimeType: resource.mimeType,\n            ...result,\n          },\n        ],\n      };\n    });\n  }\n\n  private setupPromptHandlers(server: Server) {\n    server.setRequestHandler(ListPromptsRequestSchema, async () => {\n      return {\n        prompts: this.#prompts.map((prompt) => {\n          return {\n            name: prompt.name,\n            description: prompt.description,\n            arguments: prompt.arguments,\n          };\n        }),\n      };\n    });\n\n    server.setRequestHandler(GetPromptRequestSchema, async (request) => {\n      const prompt = this.#prompts.find(\n        (prompt) => prompt.name === request.params.name,\n      );\n\n      if (!prompt) {\n        throw new McpError(\n          ErrorCode.MethodNotFound,\n          `Unknown prompt: ${request.params.name}`,\n        );\n      }\n\n      const args = request.params.arguments;\n\n      if (prompt.arguments) {\n        for (const arg of prompt.arguments) {\n          if (arg.required && !(args && arg.name in args)) {\n            throw new McpError(\n              ErrorCode.InvalidRequest,\n              `Missing required argument: ${arg.name}`,\n            );\n          }\n        }\n      }\n\n      let result: Awaited<ReturnType<Prompt[\"load\"]>>;\n\n      try {\n        result = await prompt.load(args as Record<string, string | undefined>);\n      } catch (error) {\n        throw new McpError(\n          ErrorCode.InternalError,\n          `Error loading prompt: ${error}`,\n        );\n      }\n\n      return {\n        description: prompt.description,\n        messages: [\n          {\n            role: \"user\",\n            content: { type: \"text\", text: result },\n          },\n        ],\n      };\n    });\n  }\n\n  public addTool<Params extends ToolParameters>(tool: Tool<Params>) {\n    this.#tools.push(tool as unknown as Tool);\n  }\n\n  public addResource(resource: Resource) {\n    this.#resources.push(resource);\n  }\n\n  public addPrompt<const Args extends PromptArgument[]>(prompt: Prompt<Args>) {\n    this.#prompts.push(prompt);\n  }\n\n  #httpServer: http.Server | null = null;\n\n  public async start(\n    options:\n      | { transportType: \"stdio\" }\n      | {\n          transportType: \"sse\";\n          sse: { endpoint: `/${string}`; port: number };\n        } = {\n      transportType: \"stdio\",\n    },\n  ) {\n    const capabilities: ServerCapabilities = {};\n\n    if (this.#tools.length) {\n      capabilities.tools = {};\n    }\n\n    if (this.#resources.length) {\n      capabilities.resources = {};\n    }\n\n    if (this.#prompts.length) {\n      capabilities.prompts = {};\n    }\n\n    capabilities.logging = {};\n\n    this.#server = new Server(\n      { name: this.#options.name, version: this.#options.version },\n      { capabilities },\n    );\n\n    this.setupHandlers(this.#server);\n\n    if (options.transportType === \"stdio\") {\n      const transport = new StdioServerTransport();\n\n      await this.#server.connect(transport);\n\n      console.error(`server is running on stdio`);\n    } else if (options.transportType === \"sse\") {\n      let activeTransport: SSEServerTransport | null = null;\n\n      /**\n       * Adopted from https://dev.classmethod.jp/articles/mcp-sse/\n       */\n      this.#httpServer = http.createServer(async (req, res) => {\n        if (req.method === \"GET\" && req.url === options.sse.endpoint) {\n          const transport = new SSEServerTransport(\"/messages\", res);\n\n          activeTransport = transport;\n\n          if (!this.#server) {\n            throw new Error(\"Server not initialized\");\n          }\n\n          await this.#server.connect(transport);\n\n          res.on(\"close\", () => {\n            console.log(\"SSE connection closed\");\n            if (activeTransport === transport) {\n              activeTransport = null;\n            }\n          });\n\n          this.startSending(transport);\n          return;\n        }\n\n        if (req.method === \"POST\" && req.url?.startsWith(\"/messages\")) {\n          if (!activeTransport) {\n            res.writeHead(400).end(\"No active transport\");\n            return;\n          }\n          await activeTransport.handlePostMessage(req, res);\n          return;\n        }\n\n        res.writeHead(404).end();\n      });\n\n      this.#httpServer.listen(options.sse.port, \"0.0.0.0\");\n\n      console.error(\n        `server is running on SSE at http://localhost:${options.sse.port}${options.sse.endpoint}`,\n      );\n    } else {\n      throw new Error(\"Invalid transport type\");\n    }\n  }\n\n  /**\n   * @see https://dev.classmethod.jp/articles/mcp-sse/\n   */\n  private async startSending(transport: SSEServerTransport) {\n    try {\n      await transport.send({\n        jsonrpc: \"2.0\",\n        method: \"sse/connection\",\n        params: { message: \"SSE Connection established\" },\n      });\n\n      let messageCount = 0;\n      const interval = setInterval(async () => {\n        messageCount++;\n\n        const message = `Message ${messageCount} at ${new Date().toISOString()}`;\n\n        try {\n          await transport.send({\n            jsonrpc: \"2.0\",\n            method: \"sse/message\",\n            params: { data: message },\n          });\n\n          console.log(`Sent: ${message}`);\n\n          if (messageCount === 10) {\n            clearInterval(interval);\n\n            await transport.send({\n              jsonrpc: \"2.0\",\n              method: \"sse/complete\",\n              params: { message: \"Stream completed\" },\n            });\n            console.log(\"Stream completed\");\n          }\n        } catch (error) {\n          console.error(\"Error sending message:\", error);\n          clearInterval(interval);\n        }\n      }, 1000);\n    } catch (error) {\n      console.error(\"Error in startSending:\", error);\n    }\n  }\n\n  public async stop() {\n    if (this.#httpServer) {\n      this.#httpServer.close();\n    }\n  }\n}\n"],"mappings":"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","names":["tool","resource","prompt"]}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "fastmcp",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "main": "dist/fastmcp.js",
   "scripts": {
     "build": "tsup",
-    "test": "vitest run",
+    "test": "vitest run && tsc",
     "format": "prettier --write . && eslint --fix ."
   },
   "bin": {
@@ -23,6 +23,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.4",
     "execa": "^9.5.2",
+    "file-type": "^19.6.0",
     "yargs": "^17.7.2",
     "zod": "^3.24.1",
     "zod-to-json-schema": "^3.24.1"
@@ -46,6 +47,7 @@
     "prettier": "^3.4.2",
     "semantic-release": "^24.2.0",
     "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
     "vitest": "^2.1.8"
   },
   "tsup": {

package/src/FastMCP.test.ts

@@ -1,4 +1,4 @@
-import { FastMCP, UserError } from "./FastMCP.js";
+import { FastMCP, UserError, imageContent } from "./FastMCP.js";
 import { z } from "zod";
 import { test, expect, vi } from "vitest";
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
@@ -163,7 +163,7 @@ test("returns a list", async () => {
           a: z.number(),
           b: z.number(),
         }),
-        execute: async (args) => {
+        execute: async () => {
           return {
             content: [
               { type: "text", text: "a" },
@@ -194,6 +194,55 @@ test("returns a list", async () => {
   });
 });
 
+test("returns an image", async () => {
+  await runWithTestServer({
+    start: async () => {
+      const server = new FastMCP({
+        name: "Test",
+        version: "1.0.0",
+      });
+
+      server.addTool({
+        name: "add",
+        description: "Add two numbers",
+        parameters: z.object({
+          a: z.number(),
+          b: z.number(),
+        }),
+        execute: async () => {
+          return imageContent({
+            buffer: Buffer.from(
+              "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",
+              "base64",
+            ),
+          });
+        },
+      });
+
+      return server;
+    },
+    run: async ({ client }) => {
+      expect(
+        await client.callTool({
+          name: "add",
+          arguments: {
+            a: 1,
+            b: 2,
+          },
+        }),
+      ).toEqual({
+        content: [
+          {
+            type: "image",
+            data: "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",
+            mimeType: "image/png",
+          },
+        ],
+      });
+    },
+  });
+});
+
 test("handles UserError errors", async () => {
   await runWithTestServer({
     start: async () => {
@@ -368,7 +417,7 @@ test("sends logging messages to the client", async () => {
 
       return server;
     },
-    run: async ({ client, server }) => {
+    run: async ({ client }) => {
       const onLog = vi.fn();
 
       client.setNotificationHandler(

package/src/FastMCP.ts

@@ -17,6 +17,42 @@ import {
 import { zodToJsonSchema } from "zod-to-json-schema";
 import { z } from "zod";
 import http from "http";
+import { readFile } from "fs/promises";
+import { fileTypeFromBuffer } from "file-type";
+
+export const imageContent = async (
+  input: { url: string } | { path: string } | { buffer: Buffer },
+): Promise<ImageContent> => {
+  let rawData: Buffer;
+
+  if ("url" in input) {
+    const response = await fetch(input.url);
+
+    if (!response.ok) {
+      throw new Error(`Failed to fetch image from URL: ${response.statusText}`);
+    }
+
+    rawData = Buffer.from(await response.arrayBuffer());
+  } else if ("path" in input) {
+    rawData = await readFile(input.path);
+  } else if ("buffer" in input) {
+    rawData = input.buffer;
+  } else {
+    throw new Error(
+      "Invalid input: Provide a valid 'url', 'path', or 'buffer'",
+    );
+  }
+
+  const mimeType = await fileTypeFromBuffer(rawData);
+
+  const base64Data = rawData.toString("base64");
+
+  return {
+    type: "image",
+    data: base64Data,
+    mimeType: mimeType?.mime ?? "image/png",
+  } as const;
+};
 
 abstract class FastMCPError extends Error {
   public constructor(message?: string) {
@@ -120,7 +156,7 @@ type Tool<Params extends ToolParameters = ToolParameters> = {
   execute: (
     args: z.infer<Params>,
     context: Context,
-  ) => Promise<string | ContentResult>;
+  ) => Promise<string | ContentResult | TextContent | ImageContent>;
 };
 
 type Resource = {
@@ -227,118 +263,119 @@ export class FastMCP {
       };
     });
 
-    server.setRequestHandler(
-      CallToolRequestSchema,
-      async (request, ...extra) => {
-        const tool = this.#tools.find(
-          (tool) => tool.name === request.params.name,
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+      const tool = this.#tools.find(
+        (tool) => tool.name === request.params.name,
+      );
+
+      if (!tool) {
+        throw new McpError(
+          ErrorCode.MethodNotFound,
+          `Unknown tool: ${request.params.name}`,
         );
+      }
+
+      let args: any = undefined;
 
-        if (!tool) {
+      if (tool.parameters) {
+        const parsed = tool.parameters.safeParse(request.params.arguments);
+
+        if (!parsed.success) {
           throw new McpError(
-            ErrorCode.MethodNotFound,
-            `Unknown tool: ${request.params.name}`,
+            ErrorCode.InvalidRequest,
+            `Invalid ${request.params.name} arguments`,
           );
         }
 
-        let args: any = 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;
-        }
+        args = parsed.data;
+      }
 
-        const progressToken = request.params?._meta?.progressToken;
+      const progressToken = request.params?._meta?.progressToken;
 
-        let result: ContentResult;
+      let result: ContentResult;
 
-        try {
-          const reportProgress = async (progress: Progress) => {
-            await server.notification({
-              method: "notifications/progress",
-              params: {
-                ...progress,
-                progressToken,
+      try {
+        const reportProgress = async (progress: Progress) => {
+          await server.notification({
+            method: "notifications/progress",
+            params: {
+              ...progress,
+              progressToken,
+            },
+          });
+        };
+
+        const log = {
+          debug: (message: string, context?: SerializableValue) => {
+            server.sendLoggingMessage({
+              level: "debug",
+              data: {
+                message,
+                context,
               },
             });
-          };
+          },
+          error: (message: string, context?: SerializableValue) => {
+            server.sendLoggingMessage({
+              level: "error",
+              data: {
+                message,
+                context,
+              },
+            });
+          },
+          info: (message: string, context?: SerializableValue) => {
+            server.sendLoggingMessage({
+              level: "info",
+              data: {
+                message,
+                context,
+              },
+            });
+          },
+          warn: (message: string, context?: SerializableValue) => {
+            server.sendLoggingMessage({
+              level: "warning",
+              data: {
+                message,
+                context,
+              },
+            });
+          },
+        };
 
-          const log = {
-            debug: (message: string, context?: SerializableValue) => {
-              server.sendLoggingMessage({
-                level: "debug",
-                data: {
-                  message,
-                  context,
-                },
-              });
-            },
-            error: (message: string, context?: SerializableValue) => {
-              server.sendLoggingMessage({
-                level: "error",
-                data: {
-                  message,
-                  context,
-                },
-              });
-            },
-            info: (message: string, context?: SerializableValue) => {
-              server.sendLoggingMessage({
-                level: "info",
-                data: {
-                  message,
-                  context,
-                },
-              });
-            },
-            warn: (message: string, context?: SerializableValue) => {
-              server.sendLoggingMessage({
-                level: "warning",
-                data: {
-                  message,
-                  context,
-                },
-              });
-            },
-          };
+        const maybeStringResult = await tool.execute(args, {
+          reportProgress,
+          log,
+        });
 
-          const maybeStringResult = await tool.execute(args, {
-            reportProgress,
-            log,
+        if (typeof maybeStringResult === "string") {
+          result = ContentResultZodSchema.parse({
+            content: [{ type: "text", text: maybeStringResult }],
           });
-
-          if (typeof maybeStringResult === "string") {
-            result = ContentResultZodSchema.parse({
-              content: [{ type: "text", text: maybeStringResult }],
-            });
-          } else {
-            result = ContentResultZodSchema.parse(maybeStringResult);
-          }
-        } catch (error) {
-          if (error instanceof UserError) {
-            return {
-              content: [{ type: "text", text: error.message }],
-              isError: true,
-            };
-          }
-
+        } else if ("type" in maybeStringResult) {
+          result = ContentResultZodSchema.parse({
+            content: [maybeStringResult],
+          });
+        } else {
+          result = ContentResultZodSchema.parse(maybeStringResult);
+        }
+      } catch (error) {
+        if (error instanceof UserError) {
           return {
-            content: [{ type: "text", text: `Error: ${error}` }],
+            content: [{ type: "text", text: error.message }],
             isError: true,
           };
         }
 
-        return result;
-      },
-    );
+        return {
+          content: [{ type: "text", text: `Error: ${error}` }],
+          isError: true,
+        };
+      }
+
+      return result;
+    });
   }
 
   private setupResourceHandlers(server: Server) {

package/tsconfig.json

@@ -1,3 +1,8 @@
 {
-  "extends": "@tsconfig/node22/tsconfig.json"
+  "extends": "@tsconfig/node22/tsconfig.json",
+  "compilerOptions": {
+    "noEmit": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true
+  }
 }