@nuxtjs/mcp-toolkit 0.1.0 → 0.2.0

package/README.md

@@ -39,20 +39,18 @@ Or install manually:
 
 ```bash
 # npm
-npm install -D @nuxtjs/mcp-toolkit zod@^3
+npm install -D @nuxtjs/mcp-toolkit zod
 
 # yarn
-yarn add -D @nuxtjs/mcp-toolkit zod@^3
+yarn add -D @nuxtjs/mcp-toolkit zod
 
 # pnpm
-pnpm add -D @nuxtjs/mcp-toolkit zod@^3
+pnpm add -D @nuxtjs/mcp-toolkit zod
 
 # bun
-bun add -D @nuxtjs/mcp-toolkit zod@^3
+bun add -D @nuxtjs/mcp-toolkit zod
 ```
 
-> **Note:** Zod v3 is required. Zod v4 is not yet compatible with the MCP SDK.
-
 <!-- /automd -->
 
 ## 📖 Quick Start

package/dist/module.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxtjs/mcp-toolkit",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "configKey": "mcp",
   "docs": "https://mcp-toolkit.nuxt.dev/getting-started/installation",
   "mcp": "https://mcp-toolkit.nuxt.dev/mcp",

package/dist/module.mjs

@@ -6,7 +6,7 @@ import { ROUTES } from '../dist/runtime/server/mcp/constants.js';
 import { addDevToolsCustomTabs } from '../dist/runtime/server/mcp/devtools/index.js';
 
 const name = "@nuxtjs/mcp-toolkit";
-const version = "0.1.0";
+const version = "0.2.0";
 
 const log = logger.withTag("@nuxtjs/mcp-toolkit");
 const { resolve } = createResolver(import.meta.url);

package/dist/runtime/server/mcp/definitions/prompts.d.ts

@@ -1,11 +1,12 @@
-import type { z, ZodTypeAny, ZodRawShape } from 'zod';
+import type { ZodRawShape } from 'zod';
 import type { GetPromptResult, ServerRequest, ServerNotification } from '@modelcontextprotocol/sdk/types.js';
 import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ShapeOutput } from '@modelcontextprotocol/sdk/server/zod-compat.js';
 /**
  * Callback type for MCP prompts, matching the SDK's PromptCallback type
  */
-export type McpPromptCallback<Args extends ZodRawShape | undefined = undefined> = Args extends ZodRawShape ? (args: z.objectOutputType<Args, ZodTypeAny>, extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => GetPromptResult | Promise<GetPromptResult> : (extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => GetPromptResult | Promise<GetPromptResult>;
+export type McpPromptCallback<Args extends ZodRawShape | undefined = undefined> = Args extends ZodRawShape ? (args: ShapeOutput<Args>, extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => GetPromptResult | Promise<GetPromptResult> : (extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => GetPromptResult | Promise<GetPromptResult>;
 /**
  * Definition of an MCP prompt
  * Uses `inputSchema` for consistency with tools, which is mapped to `argsSchema` when registering with the SDK

package/dist/runtime/server/mcp/definitions/resources.d.ts

@@ -15,6 +15,7 @@ export interface McpResourceAnnotations {
 export interface StandardMcpResourceDefinition {
     name?: string;
     title?: string;
+    description?: string;
     uri: string | ResourceTemplate;
     metadata?: ResourceMetadata & {
         annotations?: McpResourceAnnotations;
@@ -29,6 +30,7 @@ export interface StandardMcpResourceDefinition {
 export interface FileMcpResourceDefinition {
     name?: string;
     title?: string;
+    description?: string;
     uri?: string;
     metadata?: ResourceMetadata & {
         annotations?: McpResourceAnnotations;
@@ -65,9 +67,9 @@ export declare function registerResourceFromDefinition(server: McpServer, resour
  * export default defineMcpResource({
  *   name: 'readme',
  *   title: 'README',
+ *   description: 'Project README file',
  *   uri: 'file:///project/README.md',
  *   metadata: {
- *     description: 'Project README file',
  *     mimeType: 'text/markdown'
  *   },
  *   handler: async (uri) => {
@@ -88,10 +90,8 @@ export declare function registerResourceFromDefinition(server: McpServer, resour
  * // Simpler file-based resource
  * export default defineMcpResource({
  *   name: 'readme',
+ *   description: 'Project README file',
  *   file: 'README.md', // Automatically handles reading file and setting URI
- *   metadata: {
- *     description: 'Project README file'
- *   }
  * })
  * ```
  *

package/dist/runtime/server/mcp/definitions/resources.js

@@ -43,7 +43,8 @@ export function registerResourceFromDefinition(server, resource) {
   let handler = resource.handler;
   const metadata = {
     ...resource.metadata,
-    title: resource.title || resource.metadata?.title || title
+    title: resource.title || resource.metadata?.title || title,
+    description: resource.description || resource.metadata?.description
   };
   if ("file" in resource && resource.file) {
     const filePath = resolve(process.cwd(), resource.file);

package/dist/runtime/server/mcp/definitions/tools.d.ts

@@ -1,11 +1,12 @@
-import type { z, ZodRawShape, ZodTypeAny } from 'zod';
+import type { ZodRawShape } from 'zod';
 import type { CallToolResult, ServerRequest, ServerNotification, ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
 import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ShapeOutput } from '@modelcontextprotocol/sdk/server/zod-compat.js';
 /**
  * Callback type for MCP tools, matching the SDK's ToolCallback type
  */
-export type McpToolCallback<Args extends ZodRawShape | undefined = ZodRawShape> = Args extends ZodRawShape ? (args: z.objectOutputType<Args, ZodTypeAny>, extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => CallToolResult | Promise<CallToolResult> : (extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => CallToolResult | Promise<CallToolResult>;
+export type McpToolCallback<Args extends ZodRawShape | undefined = ZodRawShape> = Args extends ZodRawShape ? (args: ShapeOutput<Args>, extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => CallToolResult | Promise<CallToolResult> : (extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => CallToolResult | Promise<CallToolResult>;
 /**
  * Definition of an MCP tool matching the SDK's registerTool signature
  * This structure is identical to what you'd pass to server.registerTool()

package/dist/runtime/server/mcp/loaders/utils.d.ts

@@ -4,6 +4,10 @@ export interface LoadResult {
     overriddenCount: number;
 }
 export declare function createFilePatterns(paths: string[], extensions?: string[]): string[];
+/**
+ * Create file patterns for a specific layer
+ */
+export declare function createLayerFilePatterns(layerServer: string, paths: string[], extensions?: string[]): string[];
 export declare function createExcludePatterns(paths: string[], subdirs: string[]): string[];
 export declare function toIdentifier(filename: string): string;
 export declare function createTemplateContent(type: string, entries: Array<[string, string]>): string;

package/dist/runtime/server/mcp/loaders/utils.js

@@ -69,6 +69,11 @@ export function createFilePatterns(paths, extensions = ["ts", "js", "mts", "mjs"
     )
   );
 }
+export function createLayerFilePatterns(layerServer, paths, extensions = ["ts", "js", "mts", "mjs"]) {
+  return paths.flatMap(
+    (pathPattern) => extensions.map((ext) => resolvePath(layerServer, `${pathPattern}/*.${ext}`))
+  );
+}
 export function createExcludePatterns(paths, subdirs) {
   const layerDirectories = getLayerDirectories();
   return layerDirectories.flatMap(
@@ -113,22 +118,26 @@ export async function loadDefinitionFiles(paths, options = {}) {
   if (paths.length === 0) {
     return { count: 0, files: [], overriddenCount: 0 };
   }
-  const patterns = createFilePatterns(paths);
-  const files = await glob(patterns, {
-    absolute: true,
-    onlyFiles: true,
-    ignore: options.excludePatterns
-  });
+  const layerDirectories = getLayerDirectories();
+  const reversedLayers = [...layerDirectories].reverse();
   const definitionsMap = /* @__PURE__ */ new Map();
-  const filteredFiles = options.filter ? files.filter(options.filter) : files;
   let overriddenCount = 0;
-  for (const filePath of filteredFiles) {
-    const filename = filePath.split("/").pop();
-    const identifier = toIdentifier(filename);
-    if (definitionsMap.has(identifier)) {
-      overriddenCount++;
+  for (const layer of reversedLayers) {
+    const layerPatterns = createLayerFilePatterns(layer.server, paths);
+    const layerFiles = await glob(layerPatterns, {
+      absolute: true,
+      onlyFiles: true,
+      ignore: options.excludePatterns
+    });
+    const filteredFiles = options.filter ? layerFiles.filter(options.filter) : layerFiles;
+    for (const filePath of filteredFiles) {
+      const filename = filePath.split("/").pop();
+      const identifier = toIdentifier(filename);
+      if (definitionsMap.has(identifier)) {
+        overriddenCount++;
+      }
+      definitionsMap.set(identifier, filePath);
     }
-    definitionsMap.set(identifier, filePath);
   }
   const total = definitionsMap.size;
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxtjs/mcp-toolkit",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Create MCP servers directly in your Nuxt application. Define tools, resources, and prompts with a simple and intuitive API.",
   "repository": {
     "type": "git",
@@ -33,7 +33,7 @@
   ],
   "dependencies": {
     "@clack/prompts": "^0.11.0",
-    "@modelcontextprotocol/sdk": "^1.22.0",
+    "@modelcontextprotocol/sdk": "^1.23.0",
     "@nuxt/kit": "^4.2.1",
     "automd": "^0.4.2",
     "chokidar": "^4.0.3",
@@ -43,7 +43,7 @@
     "tinyglobby": "^0.2.15"
   },
   "peerDependencies": {
-    "zod": "^3.25.76"
+    "zod": "^4.1.13"
   },
   "peerDependenciesMeta": {
     "zod": {