@nuxtjs/mcp-toolkit 0.6.3 → 0.7.0

package/dist/module.json

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

package/dist/module.mjs

@@ -72,7 +72,7 @@ function generateDeeplinkUrl(baseUrl, route, ide, serverName) {
 }
 
 const name = "@nuxtjs/mcp-toolkit";
-const version = "0.6.3";
+const version = "0.7.0";
 
 const log = logger.withTag("@nuxtjs/mcp-toolkit");
 const { resolve } = createResolver(import.meta.url);
@@ -113,7 +113,8 @@ const module$1 = defineNuxtModule({
     let mcpSummary = null;
     nuxt.hook("modules:done", async () => {
       try {
-        await nuxt.callHook("mcp:definitions:paths", paths);
+        const callCustomHook = nuxt.callHook;
+        await callCustomHook("mcp:definitions:paths", paths);
         const result = await loadAllDefinitions(paths);
         if (result.handlers && result.handlers.count > 0) {
           addServerHandler({

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

@@ -1,9 +1,27 @@
 import type { ZodRawShape } from 'zod';
-import type { CallToolResult, ServerRequest, ServerNotification, ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
+import type { CallToolResult, 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';
 import { type MsCacheDuration, type McpCacheOptions, type McpCache } from './cache.js';
+/**
+ * Hints that describe tool behavior to MCP clients.
+ *
+ * Clients may use these to decide whether to prompt the user for confirmation (human-in-the-loop).
+ * All properties are optional hints — they are not guaranteed to be respected by every client.
+ *
+ * @see https://modelcontextprotocol.io/docs/concepts/tools#tool-annotations
+ */
+export interface McpToolAnnotations {
+    /** If `true`, the tool does not modify any state (e.g. a read/search/lookup). Defaults to `false`. */
+    readOnlyHint?: boolean;
+    /** If `true`, the tool may perform destructive operations like deleting data. Only meaningful when `readOnlyHint` is `false`. Defaults to `true`. */
+    destructiveHint?: boolean;
+    /** If `true`, calling the tool multiple times with the same arguments has no additional effect beyond the first call. Only meaningful when `readOnlyHint` is `false`. Defaults to `false`. */
+    idempotentHint?: boolean;
+    /** If `true`, the tool may interact with the outside world (e.g. external APIs, the internet). If `false`, the tool only operates on local/internal data. Defaults to `true`. */
+    openWorldHint?: boolean;
+}
 export type { MsCacheDuration };
 export type McpToolCacheOptions<Args = unknown> = McpCacheOptions<Args>;
 export type McpToolCache<Args = unknown> = McpCache<Args>;
@@ -21,7 +39,8 @@ export interface McpToolDefinition<InputSchema extends ZodRawShape | undefined =
     description?: string;
     inputSchema?: InputSchema;
     outputSchema?: OutputSchema;
-    annotations?: ToolAnnotations;
+    annotations?: McpToolAnnotations;
+    inputExamples?: InputSchema extends ZodRawShape ? Partial<ShapeOutput<InputSchema>>[] : never;
     _meta?: Record<string, unknown>;
     handler: McpToolCallback<InputSchema>;
     /**

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

@@ -25,7 +25,10 @@ export function registerToolFromDefinition(server, tool) {
     inputSchema: tool.inputSchema,
     outputSchema: tool.outputSchema,
     annotations: tool.annotations,
-    _meta: tool._meta
+    _meta: {
+      ...tool._meta,
+      ...tool.inputExamples && { inputExamples: tool.inputExamples }
+    }
   };
   return server.registerTool(name, options, handler);
 }

package/dist/runtime/server/mcp/devtools/index.js

@@ -1,5 +1,5 @@
 import { logger } from "@nuxt/kit";
-import { addCustomTab } from "@nuxt/devtools-kit";
+import { refreshCustomTabs } from "@nuxt/devtools-kit";
 import { spawn } from "node:child_process";
 const log = logger.withTag("@nuxtjs/mcp-toolkit");
 const INSPECTOR_TIMEOUT = 15e3;
@@ -120,7 +120,14 @@ async function launchMcpInspector(nuxt, options) {
   if (inspectorProcess) {
     return;
   }
-  const mcpServerUrl = `http://localhost:${nuxt.options.devServer?.port || 3e3}${options.route || "/mcp"}`;
+  const devServerUrl = nuxt.options.devServer?.url;
+  let mcpServerUrl;
+  if (devServerUrl) {
+    mcpServerUrl = `${devServerUrl.replace(/\/$/, "")}${options.route || "/mcp"}`;
+  } else {
+    const protocol = nuxt.options.devServer?.https ? "https" : "http";
+    mcpServerUrl = `${protocol}://localhost:${nuxt.options.devServer?.port || 3e3}${options.route || "/mcp"}`;
+  }
   const inspectorClientPort = getInspectorClientPort();
   const inspectorServerPort = getInspectorServerPort();
   const inspectorBaseUrl = buildInspectorBaseUrl(inspectorClientPort);
@@ -135,12 +142,13 @@ async function launchMcpInspector(nuxt, options) {
     inspectorProcess = spawn("npx", [
       "-y",
       "@modelcontextprotocol/inspector",
-      "streamable-http",
+      "--transport",
+      "http",
+      "--server-url",
       mcpServerUrl
     ], {
       stdio: ["ignore", "pipe", "pipe"],
-      env,
-      shell: true
+      env
     });
     const childProcess = inspectorProcess;
     let stdoutBuffer = "";
@@ -304,38 +312,44 @@ export function addDevToolsCustomTabs(nuxt, options) {
   if (!options.enabled) {
     return;
   }
-  addCustomTab(() => ({
-    category: "server",
-    name: "mcp-inspector",
-    title: "MCP Inspector",
-    icon: "i-lucide-circuit-board",
-    view: isReady && inspectorUrl ? {
-      type: "iframe",
-      src: inspectorUrl
-    } : {
-      type: "launch",
-      description: "Launch MCP Inspector to test/debug your MCP server",
-      actions: [
-        {
-          label: promise ? "Starting..." : "Launch Inspector",
-          pending: !!promise,
-          handle() {
-            promise = promise || launchMcpInspector(nuxt, options).finally(() => {
+  const registerCustomHook = nuxt.hook;
+  registerCustomHook("devtools:customTabs", (tabsArg) => {
+    const tabs = tabsArg;
+    tabs.push({
+      category: "server",
+      name: "mcp-inspector",
+      title: "MCP Inspector",
+      icon: "i-lucide-circuit-board",
+      view: isReady && inspectorUrl ? {
+        type: "iframe",
+        src: inspectorUrl
+      } : {
+        type: "launch",
+        description: "Launch MCP Inspector to test/debug your MCP server",
+        actions: [
+          {
+            label: promise ? "Starting..." : "Launch Inspector",
+            pending: !!promise,
+            handle() {
+              promise = promise || launchMcpInspector(nuxt, options).then(() => {
+                refreshCustomTabs(nuxt);
+              }).finally(() => {
+                promise = null;
+              });
+              return promise;
+            }
+          },
+          ...inspectorProcess ? [{
+            label: "Stop Inspector",
+            handle() {
+              stopMcpInspector();
               promise = null;
-            });
-            return promise;
-          }
-        },
-        ...inspectorProcess ? [{
-          label: "Stop Inspector",
-          handle() {
-            stopMcpInspector();
-            promise = null;
-          }
-        }] : []
-      ]
-    }
-  }), nuxt);
+            }
+          }] : []
+        ]
+      }
+    });
+  });
   nuxt.hook("close", () => {
     stopMcpInspector();
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxtjs/mcp-toolkit",
-  "version": "0.6.3",
+  "version": "0.7.0",
   "description": "Create MCP servers directly in your Nuxt application. Define tools, resources, and prompts with a simple and intuitive API.",
   "repository": {
     "type": "git",
@@ -39,18 +39,18 @@
     "dist"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.3",
-    "@nuxt/kit": "^4.3.0",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@nuxt/kit": "^4.3.1",
     "defu": "^6.1.4",
     "ms": "^2.1.3",
     "pathe": "^2.0.3",
-    "satori": "^0.19.1",
+    "satori": "^0.19.2",
     "scule": "^1.3.0",
     "tinyglobby": "^0.2.15"
   },
   "peerDependencies": {
     "zod": "^4.1.13",
-    "agents": ">=0.3.6"
+    "agents": ">=0.4.1"
   },
   "peerDependenciesMeta": {
     "zod": {
@@ -61,15 +61,15 @@
     }
   },
   "devDependencies": {
-    "@nuxt/devtools": "^3.1.1",
-    "@nuxt/eslint-config": "^1.13.0",
+    "@nuxt/devtools": "^3.2.1",
+    "@nuxt/eslint-config": "^1.15.1",
     "@nuxt/module-builder": "^1.0.2",
-    "@nuxt/schema": "^4.3.0",
-    "@nuxt/test-utils": "^3.23.0",
+    "@nuxt/schema": "^4.3.1",
+    "@nuxt/test-utils": "^4.0.0",
     "@types/node": "latest",
     "changelogen": "^0.6.2",
     "eslint": "^9.39.2",
-    "nuxt": "^4.3.0",
+    "nuxt": "^4.3.1",
     "typescript": "~5.9.3",
     "vitest": "^4.0.18",
     "vue-tsc": "^3.2.4"