@muzikanto/nestjs-mcp 1.6.0 → 1.7.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @muzikanto/nestjs-mcp
 
+## 1.7.1
+
+### Patch Changes
+
+- add exports for (client, server) and update example (add openai)
+
+## 1.7.0
+
+### Minor Changes
+
+- fix tool result format
+
 ## 1.6.0
 
 ### Minor Changes

package/README.md

@@ -85,7 +85,7 @@ export class AppModule {}
 ```ts
 import { IMcpTool, McpTool } from "@muzikanto/nestjs-mcp";
 import { Telegraf } from "telegraf";
-import z from "zod";
+import z from "zod/v3";
 
 const schema = {
   chatId: z.number().describe("Telegram chat id"), // строка с описанием
@@ -98,14 +98,16 @@ export class TelegramSendMessageTool implements IMcpTool<
   { success: boolean }
 > {
   name = "telegram.sendMessage";
-
   inputSchema = schema;
 
   constructor(private readonly bot: Telegraf) {}
 
   async execute(input: { chatId: string; text: string }) {
     await this.bot.telegram.sendMessage(input.chatId, input.text);
-    return { success: true };
+    return {
+      structuredContent: { success: true },
+      messages: [{ type: "text", text: "Success sent to user" }],
+    };
   }
 }
 ```
@@ -128,9 +130,10 @@ POST /mcp/tools
 
 ```json
 {
-  "data": {
+  "structuredContent": {
     "success": true
-  }
+  },
+  "messages": [{ "type": "text", "text": "Success sent to user" }]"
 }
 ```
 
@@ -167,7 +170,7 @@ GET /mcp/tools
 
 ```ts
 import { IMcpPrompt, McpPrompt } from "@muzikanto/nestjs-mcp";
-import z from "zod";
+import z from "zod/v3";
 
 const schema = {
   chatId: z.number().describe("Telegram chat id"), // строка с описанием
@@ -185,26 +188,28 @@ export class TelegramAutoReplyPrompt implements IMcpPrompt<{
   schema = schema;
 
   async execute({ text, chatId }: { text: string; chatId: number }) {
-    return [
-      {
-        role: "system",
-        content: `You are a friendly Telegram bot. Reply briefly and to the point.`,
-      },
-      {
-        role: "user",
-        content: text,
-      },
-      {
-        role: "assistant",
-        tool_call: {
-          name: "telegram.sendMessage",
-          arguments: {
-            chatId,
-            text: "{{model_output}}",
+    return {
+      messages: [
+        {
+          role: "system",
+          content: `You are a friendly Telegram bot. Reply briefly and to the point.`,
+        },
+        {
+          role: "user",
+          content: text,
+        },
+        {
+          role: "assistant",
+          tool_call: {
+            name: "telegram.sendMessage",
+            arguments: {
+              chatId,
+              text: "{{model_output}}",
+            },
           },
         },
-      },
-    ];
+      ],
+    };
   }
 }
 ```
@@ -349,7 +354,11 @@ export class McpDynamic {
     this.mcpDynamicService.registerTool({
       name: "dynamic_tool",
       title: "Dynamic tool",
-      execute: () => Promise.resolve("test"),
+      execute: () =>
+        Promise.resolve({
+          structuredContent: { text: "test" },
+          messages: [{ type: "text" as const, text: "test" }],
+        }),
       guards: [ExampleGuard],
       interceptors: [ExampleInterceptor],
     });
@@ -357,7 +366,8 @@ export class McpDynamic {
     this.mcpDynamicService.registerPrompt({
       name: "dynamic_prompt",
       title: "Dynamic prompt",
-      execute: () => Promise.resolve([{ role: "assistant", content: "test" }]),
+      execute: () =>
+        Promise.resolve({ messages: [{ role: "assistant", content: "test" }] }),
       guards: [ExampleGuard],
       interceptors: [ExampleInterceptor],
     });
@@ -370,6 +380,11 @@ export class McpDynamic {
         Promise.resolve([{ uri: uri.href, text: `ID: ${input.testId}` }]),
       guards: [ExampleGuard],
       interceptors: [ExampleInterceptor],
+      list: async () => {
+        return [
+          { uri: "dynamic://test/1", name: "dynamice_1", title: "Dynamic 1" },
+        ];
+      },
     });
   }
 }
@@ -405,7 +420,10 @@ export class TelegramSendMessageTool implements IMcpTool<
 
   async execute() {
     // await this.bot.telegram.sendMessage(input.chatId, input.text);
-    return { success: true };
+    return {
+      structuredContent: { success: true },
+      messages: { type: "text", text: "Success sent" },
+    };
   }
 }
 ```
@@ -473,7 +491,10 @@ export class TelegramSendMessageTool implements IMcpTool<
 
   async execute() {
     // await this.bot.telegram.sendMessage(input.chatId, input.text);
-    return { success: true };
+    return {
+      success: true,
+      messagse: [{ type: "text", text: "Success sent" }],
+    };
   }
 }
 ```
@@ -521,7 +542,7 @@ class NotImplExceptionFilter implements ExceptionFilter {
   catch(exception: unknown, host: ArgumentsHost) {
     return {
       isError: true,
-      text: (exception as Error).message,
+      messages: [{ type: "text", text: "Not implemented tool" }],
     };
   }
 }
@@ -531,7 +552,7 @@ class AuthExceptionFilter implements ExceptionFilter {
   catch(exception: unknown, host: ArgumentsHost) {
     return {
       isError: true,
-      text: (exception as Error).message,
+      messages: [{ type: "text", text: "No access" }],
     };
   }
 }
@@ -553,25 +574,35 @@ export class TelegramSendMessageTool implements IMcpTool<
 
 ### Integration with OpenAI Function Calls
 
+Example with `openai`: `6.25.0`
+
 ```ts
-import axios from 'axios';
-import OpenAI from 'openai';
+import axios from "axios";
+import OpenAI from "openai";
 
-const MCP_TOOLS_URL = 'http://localhost:3000/mcp/tools';
-const MCP_TELEGRAM_PROMPT_URL = 'http://localhost:3000/mcp/prompts/telegram_auto_reply';
+const MCP_TOOLS_URL = "http://localhost:3000/mcp/tools";
+const MCP_TELEGRAM_PROMPT_URL =
+  "http://localhost:3000/mcp/prompts/telegram_auto_reply";
 
 // Create OpenAI client
-const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
+const client = new OpenAI({
+  baseUrl: "https://openrouter.ai/api/v1",
+  apiKey: process.env.OPENROUTER_API_KEY,
+});
 
 /**
  * Get all tools
  */
 async function getMcpTools() {
   const response = await axios.get(MCP_TOOLS_URL);
-  return response.data.tools.map(el => ({
-    name: el.name,
-    description: el.description,
-    parameters: el.inputSchema,
+
+  return response.data.tools.map((el) => ({
+    type: "function",
+    function: {
+      name: el.name,
+      description: el.description,
+      parameters: el.inputSchema,
+    },
   }));
 }
 
@@ -579,17 +610,17 @@ async function getMcpTools() {
  * Get all prompts
  */
 async function getMcpPrompt() {
-  const response = await axios.post(MCP_TELEGRAM_PROMPT_URL, {/* prompt generation arguments */});
+  const response = await axios.post(MCP_TELEGRAM_PROMPT_URL, {
+    /* prompt generation arguments */
+  });
   return response.data;
+}
 
 /**
  * Request mcp tool
  */
 async function callMcpTool(toolName: string, payload: Record<string, any>) {
-  const response = await axios.post(
-    MCP_TOOLS_URL,
-    { type: toolName, payload },
-  );
+  const response = await axios.post(MCP_TOOLS_URL, { type: toolName, payload });
   return response.data;
 }
 
@@ -601,20 +632,20 @@ async function callMcpTool(toolName: string, payload: Record<string, any>) {
   const promptResponse = await getMcpPrompt();
 
   const completion = await client.chat.completions.create({
-    model: 'gpt-4.1-mini',
+    model: "arcee-ai/trinity-large-preview:free",
     messages: promptResponse.messages,
-    functions: toolsResponse.tools,
-    function_call: 'auto',
+    tools: toolsResponse,
+    tool_choice: "auto",
   });
 
   const message = completion.choices[0].message;
 
-  if (message.function_call) {
-    const { name, arguments: argsJson } = message.function_call;
+  if (message.tool_calls?.length) {
+    const { name, arguments: argsJson } = message.tool_calls[0].function;
     const args = JSON.parse(argsJson);
 
-    const result = await callMcpTool(name, args);
-    console.log('Result from MCP tool:', result);
+    const { messages, structuredContent } = await callMcpTool(name, args);
+    console.log("Result from MCP tool:", messages, structuredContent);
   }
 })();
 ```

package/dist/index.d.ts

@@ -1,8 +1,2 @@
-export * from "./mcp-server/mcp.module";
-export * from "./mcp-server/decorators/mcp-tool.decorator";
-export * from "./mcp-server/decorators/mcp-prompt.decorator";
-export * from "./mcp-server/decorators/mcp-resource.decorator";
-export * from "./mcp-client/mcp-client.module";
-export * from "./mcp-client/mcp-client.service";
-export * from "./mcp-server/services/mcp-dynamic.service";
-export * from "./mcp-server/exceptions";
+export * from "./mcp-client";
+export * from "./mcp-server";

package/dist/index.js

@@ -14,11 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./mcp-server/mcp.module"), exports);
-__exportStar(require("./mcp-server/decorators/mcp-tool.decorator"), exports);
-__exportStar(require("./mcp-server/decorators/mcp-prompt.decorator"), exports);
-__exportStar(require("./mcp-server/decorators/mcp-resource.decorator"), exports);
-__exportStar(require("./mcp-client/mcp-client.module"), exports);
-__exportStar(require("./mcp-client/mcp-client.service"), exports);
-__exportStar(require("./mcp-server/services/mcp-dynamic.service"), exports);
-__exportStar(require("./mcp-server/exceptions"), exports);
+__exportStar(require("./mcp-client"), exports);
+__exportStar(require("./mcp-server"), exports);

package/dist/mcp-client/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./mcp-client.module";
+export * from "./mcp-client.service";
+export * from "./utils/openai";

package/dist/mcp-client/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./mcp-client.module"), exports);
+__exportStar(require("./mcp-client.service"), exports);
+__exportStar(require("./utils/openai"), exports);

package/dist/mcp-client/mcp-client.module.d.ts

@@ -1,4 +1,4 @@
-import { Provider, Type } from "@nestjs/common";
+import { DynamicModule, Type } from "@nestjs/common";
 export interface IMcpClientConfig {
     url: string;
 }
@@ -7,9 +7,5 @@ export declare class McpClientModule {
         useValue?: IMcpClientConfig;
         useExisting?: Type<IMcpClientConfig>;
         useFactory?: (...args: any) => IMcpClientConfig | Promise<IMcpClientConfig>;
-    }): {
-        module: typeof McpClientModule;
-        implements: import("@nestjs/common").DynamicModule[];
-        providers: Provider<IMcpClientConfig>[];
-    };
+    }): DynamicModule;
 }

package/dist/mcp-client/mcp-client.module.js

@@ -24,15 +24,17 @@ let McpClientModule = McpClientModule_1 = class McpClientModule {
         };
         return {
             module: McpClientModule_1,
-            implements: [
+            imports: [
                 axios_1.HttpModule.registerAsync({
-                    inject: [inject_tokens_1.MCP_CLIENT_CONFIG],
                     useFactory: (config) => {
-                        return { baseUrl: config.url };
+                        return { baseURL: config.url };
                     },
+                    inject: [inject_tokens_1.MCP_CLIENT_CONFIG],
+                    extraProviders: [configProvider],
                 }),
             ],
             providers: [mcp_client_service_1.McpClientService, configProvider],
+            exports: [mcp_client_service_1.McpClientService],
         };
     }
 };

package/dist/mcp-client/mcp-client.service.d.ts

@@ -1,12 +1,13 @@
 import { HttpService } from "@nestjs/axios";
 import { McpToolsDto } from "../mcp-server/dto/McpTools.dto";
 import { McpPromptsDto } from "../mcp-server/dto/McpPrompts.dto";
-import { McpPromptMessagesDto } from "../mcp-server/dto/McpPromptMessages.dto";
+import { McpPromptResultDto } from "../mcp-server/dto/McpPrompResult.dto";
+import { McpToolResultDto } from "../mcp-server/dto/McpToolResult.dto";
 export declare class McpClientService {
     private readonly httpService;
     constructor(httpService: HttpService);
     getAllTools(): Promise<McpToolsDto>;
     getAllPrompts(): Promise<McpPromptsDto>;
-    getPromptByName<Payload = any>(promptName: string, params: Payload): Promise<McpPromptMessagesDto>;
-    callMcpTool<Payload = any, Result = any>(toolName: string, payload: Payload): Promise<Result>;
+    getPromptByName<Payload = any>(promptName: string, params: Payload): Promise<McpPromptResultDto>;
+    callMcpTool<Payload = any, Result = any>(toolName: string, payload: Payload): Promise<McpToolResultDto<Result>>;
 }

package/dist/mcp-client/utils/openai.d.ts

@@ -0,0 +1,34 @@
+import { McpToolDto } from "../../mcp-server/dto/McpTool.dto";
+type OpenAiCall = {
+    function: {
+        name: string;
+        arguments: string;
+    };
+};
+export declare class McpOpenAiHelper {
+    static convertTools(tools: McpToolDto[]): {
+        type: "function";
+        function: {
+            name: string;
+            description: string | undefined;
+            parameters: any;
+        };
+    }[];
+    static convertTool(tool: McpToolDto): {
+        type: "function";
+        function: {
+            name: string;
+            description: string | undefined;
+            parameters: any;
+        };
+    };
+    static convertToolCalls(toolCalls: OpenAiCall[]): {
+        name: string;
+        payload: any;
+    }[];
+    static convertToolCall({ function: { name, arguments: args }, }: OpenAiCall): {
+        name: string;
+        payload: any;
+    };
+}
+export {};

package/dist/mcp-client/utils/openai.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpOpenAiHelper = void 0;
+class McpOpenAiHelper {
+    static convertTools(tools) {
+        return tools.map((tool) => McpOpenAiHelper.convertTool(tool));
+    }
+    static convertTool(tool) {
+        return {
+            type: "function",
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.inputSchema,
+            },
+        };
+    }
+    static convertToolCalls(toolCalls) {
+        return toolCalls.map((toolCall) => McpOpenAiHelper.convertToolCall(toolCall));
+    }
+    static convertToolCall({ function: { name, arguments: args }, }) {
+        const argsJson = JSON.parse(args || "{}");
+        return {
+            name,
+            payload: argsJson,
+        };
+    }
+}
+exports.McpOpenAiHelper = McpOpenAiHelper;

package/dist/mcp-server/controllers/mcp.controller.d.ts

@@ -3,21 +3,22 @@ import { McpService } from "../services/mcp.service";
 import { McpMessageDto } from "../dto/McpMessage.dto";
 import { McpToolsDto } from "../dto/McpTools.dto";
 import { McpPromptsDto } from "../dto/McpPrompts.dto";
-import { McpPromptMessagesDto } from "../dto/McpPromptMessages.dto";
+import { McpPromptResultDto } from "../dto/McpPrompResult.dto";
 import { IMcpConfig } from "../config";
 import { McpResourcesDto } from "../dto/McpResources.dto";
-import { McpResourceItemsDto } from "../dto/McpResourceItems.dto";
+import { McpResourceResultDto } from "../dto/McpResourceResult.dto";
 import { McpResourceRequestDto } from "../dto/McpResourceRequest.dto";
+import { McpToolResultDto } from "../dto/McpToolResult.dto";
 export declare class McpController {
     private readonly service;
     private readonly guard;
     private readonly config;
     constructor(service: McpService, guard: CanActivate, config: IMcpConfig);
-    handleTool(body: McpMessageDto, request: any, context: ExecutionContext): Promise<any>;
+    handleTool(body: McpMessageDto, request: any, context: ExecutionContext): Promise<McpToolResultDto>;
     getTools(context: ExecutionContext): Promise<McpToolsDto>;
     getPrompts(context: ExecutionContext): Promise<McpPromptsDto>;
-    getPrompt(name: string, body: object, context: ExecutionContext): Promise<McpPromptMessagesDto>;
+    getPrompt(name: string, body: object, context: ExecutionContext): Promise<McpPromptResultDto>;
     getResources(context: ExecutionContext): Promise<McpResourcesDto>;
-    executeResource(name: string, body: McpResourceRequestDto, context: ExecutionContext): Promise<McpResourceItemsDto>;
+    executeResource(name: string, body: McpResourceRequestDto, context: ExecutionContext): Promise<McpResourceResultDto>;
     private checkGuard;
 }

package/dist/mcp-server/controllers/mcp.controller.js

@@ -19,15 +19,16 @@ const McpMessage_dto_1 = require("../dto/McpMessage.dto");
 const swagger_1 = require("@nestjs/swagger");
 const McpTools_dto_1 = require("../dto/McpTools.dto");
 const McpPrompts_dto_1 = require("../dto/McpPrompts.dto");
-const McpPromptMessages_dto_1 = require("../dto/McpPromptMessages.dto");
+const McpPrompResult_dto_1 = require("../dto/McpPrompResult.dto");
 const context_decorator_1 = require("../utils/context.decorator");
 const inject_tokens_1 = require("../utils/inject-tokens");
 const config_1 = require("../config");
 const rxjs_1 = require("rxjs");
 const McpResources_dto_1 = require("../dto/McpResources.dto");
-const McpResourceItems_dto_1 = require("../dto/McpResourceItems.dto");
+const McpResourceResult_dto_1 = require("../dto/McpResourceResult.dto");
 const McpResourceRequest_dto_1 = require("../dto/McpResourceRequest.dto");
 const uri_1 = require("../utils/uri");
+const McpToolResult_dto_1 = require("../dto/McpToolResult.dto");
 let McpController = class McpController {
     service;
     guard;
@@ -56,10 +57,8 @@ let McpController = class McpController {
     async getPrompt(name, body, context) {
         await this.checkGuard(context);
         const observable = await this.service.executePrompt(name, body, context);
-        const messages = await (0, rxjs_1.firstValueFrom)(observable);
-        return {
-            messages,
-        };
+        const result = await (0, rxjs_1.firstValueFrom)(observable);
+        return result;
     }
     async getResources(context) {
         await this.checkGuard(context);
@@ -74,8 +73,8 @@ let McpController = class McpController {
             ? (0, uri_1.extractResourceParams)(resource.instance.uri, body.uri)
             : {};
         const observable = await this.service.executeResource(name, url, params, context);
-        const contents = await (0, rxjs_1.firstValueFrom)(observable);
-        return { contents };
+        const result = await (0, rxjs_1.firstValueFrom)(observable);
+        return result;
     }
     async checkGuard(context) {
         if (!(await this.guard.canActivate(context))) {
@@ -91,6 +90,7 @@ __decorate([
         summary: "Request tool",
     }),
     (0, swagger_1.ApiResponse)({
+        type: McpToolResult_dto_1.McpToolResultDto,
         status: 200,
         description: "Tool execution result",
     }),
@@ -155,7 +155,7 @@ __decorate([
     (0, swagger_1.ApiResponse)({
         status: 200,
         description: "Prompt messages",
-        type: McpPromptMessages_dto_1.McpPromptMessagesDto,
+        type: McpPrompResult_dto_1.McpPromptResultDto,
     }),
     (0, swagger_1.ApiNotFoundResponse)({
         description: "Not found prompt",
@@ -203,7 +203,7 @@ __decorate([
     (0, swagger_1.ApiResponse)({
         status: 200,
         description: "Resource template result",
-        type: McpResourceItems_dto_1.McpResourceItemsDto,
+        type: McpResourceResult_dto_1.McpResourceResultDto,
     }),
     (0, swagger_1.ApiNotFoundResponse)({
         description: "Not found resource template",
@@ -219,6 +219,7 @@ __decorate([
     __metadata("design:returntype", Promise)
 ], McpController.prototype, "executeResource", null);
 exports.McpController = McpController = __decorate([
+    (0, swagger_1.ApiTags)("MCP server"),
     (0, common_1.Controller)("mcp"),
     __param(1, (0, common_1.Inject)(inject_tokens_1.MCP_GUARD)),
     __param(2, (0, config_1.InjectMcpConfig)()),

package/dist/mcp-server/controllers/mcp.sse.controller.js

@@ -72,6 +72,7 @@ __decorate([
     __metadata("design:returntype", Promise)
 ], McpSseController.prototype, "handleSseMessages", null);
 exports.McpSseController = McpSseController = __decorate([
+    (0, swagger_1.ApiTags)("MCP server"),
     (0, common_1.Controller)("mcp"),
     __param(1, (0, common_1.Inject)(inject_tokens_1.MCP_GUARD)),
     __param(2, (0, config_1.InjectMcpConfig)()),

package/dist/mcp-server/decorators/mcp-prompt.decorator.d.ts

@@ -2,7 +2,11 @@ import "reflect-metadata";
 import type * as z3 from "zod/v3";
 type AnySchema = z3.ZodTypeAny;
 type ZodRawShapeCompat = Record<string, AnySchema>;
-export type IMcpPromptMessage = {
+export type IMcpPromptResult = {
+    messages: IMcpPromptResultMessage[];
+    description?: string;
+};
+export type IMcpPromptResultMessage = {
     role: "user" | "assistant" | "system";
     content?: string;
     tool_call?: {
@@ -10,12 +14,12 @@ export type IMcpPromptMessage = {
         arguments: object;
     };
 };
-export interface IMcpPrompt<Payload = any, Result extends IMcpPromptMessage[] = IMcpPromptMessage[]> {
+export interface IMcpPrompt<Payload = any> {
     name: string;
     title?: string;
     description?: string;
     inputSchema?: ZodRawShapeCompat;
-    execute(input: Payload): Promise<Result>;
+    execute(input: Payload): Promise<IMcpPromptResult>;
 }
 export declare const MCP_PROMPT_METADATA = "mcp:prompt-class";
 /**

package/dist/mcp-server/decorators/mcp-resource.decorator.d.ts

@@ -1,10 +1,13 @@
-import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol";
-import { ServerNotification, ServerRequest } from "@modelcontextprotocol/sdk/types";
+import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import { Resource, ServerNotification, ServerRequest } from "@modelcontextprotocol/sdk/types.js";
 import "reflect-metadata";
-export type IMcpResourceResult = {
+export type IMcpResourceResultItem = {
     uri: string;
     text: string;
 };
+export type IMcpResourceResult = {
+    contents: IMcpResourceResultItem[];
+};
 export type IMcpResourceListItem = {
     name: string;
     uri: string;
@@ -16,7 +19,9 @@ export interface IMcpResource<Payload = any> {
     uri: string;
     title?: string;
     description?: string;
-    execute(url: URL, input: Payload): Promise<IMcpResourceResult[]>;
+    annotations?: Resource["annotations"];
+    _meta?: Resource["_meta"];
+    execute(url: URL, input: Payload): Promise<IMcpResourceResult>;
     list?(extra: RequestHandlerExtra<ServerRequest, ServerNotification>): Promise<IMcpResourceListItem[]>;
 }
 export declare const MCP_RESOURCE_METADATA = "mcp:resource-class";

package/dist/mcp-server/decorators/mcp-tool.decorator.d.ts

@@ -1,13 +1,25 @@
+import { ToolAnnotations } from "@modelcontextprotocol/sdk/types.js";
 import "reflect-metadata";
 import type * as z3 from "zod/v3";
 type AnySchema = z3.ZodTypeAny;
 type ZodRawShapeCompat = Record<string, AnySchema>;
-export interface IMcpTool<Payload = any, Result = any> {
+export type IMcpToolResult<Result extends Record<string, unknown>> = {
+    structuredContent?: Result;
+    messages: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+};
+export interface IMcpTool<Payload = any, Result extends Record<string, unknown> = Record<string, unknown>> {
     name: string;
     title?: string;
     description?: string;
     inputSchema?: ZodRawShapeCompat;
-    execute(input: Payload): Promise<Result>;
+    outputSchema?: ZodRawShapeCompat;
+    annotations?: ToolAnnotations;
+    _meta?: Record<string, unknown>;
+    execute(input: Payload): Promise<IMcpToolResult<Result>>;
 }
 export declare const MCP_TOOL_METADATA = "mcp:tool-class";
 /**

package/dist/mcp-server/dto/IMcpResourceResult.dto.d.ts

@@ -0,0 +1,4 @@
+import { McpResourceItemDto } from "./McpResourceItem.dto";
+export declare class McpResourceItemsDto {
+    contents: McpResourceItemDto[];
+}