@nuxtjs/mcp-toolkit 0.6.4 → 0.7.0

package/dist/module.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxtjs/mcp-toolkit",
-  "version": "0.6.4",
+  "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.4";
+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

@@ -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);
@@ -305,7 +312,9 @@ export function addDevToolsCustomTabs(nuxt, options) {
   if (!options.enabled) {
     return;
   }
-  nuxt.hook("devtools:customTabs", (tabs) => {
+  const registerCustomHook = nuxt.hook;
+  registerCustomHook("devtools:customTabs", (tabsArg) => {
+    const tabs = tabsArg;
     tabs.push({
       category: "server",
       name: "mcp-inspector",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxtjs/mcp-toolkit",
-  "version": "0.6.4",
+  "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",
@@ -44,13 +44,13 @@
     "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.4.0"
+    "agents": ">=0.4.1"
   },
   "peerDependenciesMeta": {
     "zod": {
@@ -61,11 +61,11 @@
     }
   },
   "devDependencies": {
-    "@nuxt/devtools": "^3.1.1",
+    "@nuxt/devtools": "^3.2.1",
     "@nuxt/eslint-config": "^1.15.1",
     "@nuxt/module-builder": "^1.0.2",
     "@nuxt/schema": "^4.3.1",
-    "@nuxt/test-utils": "^3.23.0",
+    "@nuxt/test-utils": "^4.0.0",
     "@types/node": "latest",
     "changelogen": "^0.6.2",
     "eslint": "^9.39.2",