@nuxtjs/mcp-toolkit 0.6.1 → 0.6.3

package/dist/module.json

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

package/dist/module.mjs

@@ -1,13 +1,78 @@
-import { execSync } from 'node:child_process';
-import { logger, createResolver, defineNuxtModule, addComponent, addServerHandler, addServerTemplate, addServerImports } from '@nuxt/kit';
-import { defu } from 'defu';
+import { logger, createResolver, defineNuxtModule, addComponent, addServerTemplate, addServerHandler, addServerImports } from '@nuxt/kit';
 import { loadAllDefinitions } from '../dist/runtime/server/mcp/loaders/index.js';
-import { defaultMcpConfig } from '../dist/runtime/server/mcp/config.js';
+import { defaultMcpConfig, getMcpConfig } from '../dist/runtime/server/mcp/config.js';
 import { ROUTES } from '../dist/runtime/server/mcp/constants.js';
 import { addDevToolsCustomTabs } from '../dist/runtime/server/mcp/devtools/index.js';
+import { execSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+const IDE_CONFIGS = {
+  cursor: { name: "Cursor" },
+  vscode: { name: "VS Code" }
+};
+function terminalLink(text, url) {
+  return `\x1B]8;;${url}\x07${text}\x1B]8;;\x07`;
+}
+function isMCPInstalled(mcpJson, mcpUrl) {
+  if (!mcpJson.mcpServers) return false;
+  return Object.values(mcpJson.mcpServers).some((server) => server.url === mcpUrl);
+}
+function detectIDE() {
+  const env = process.env;
+  if (env.__CFBundleIdentifier === "com.todesktop.230313mzl4w4u92") return "cursor";
+  if (env.__CFBundleIdentifier === "com.microsoft.VSCode") return "vscode";
+  if (env.CURSOR_TRACE_ID) return "cursor";
+  const ipc = env.VSCODE_IPC_HOOK || "";
+  if (ipc.includes("/Cursor/")) return "cursor";
+  if (ipc.includes("/Code/")) return "vscode";
+  try {
+    let pid = process.ppid;
+    for (let i = 0; i < 10 && pid > 1; i++) {
+      const name = execSync(`ps -o comm= -p ${pid}`, { stdio: ["pipe", "pipe", "ignore"] }).toString().toLowerCase();
+      if (name.includes("cursor")) return "cursor";
+      if (name.includes("code helper") || name.includes("code.app")) return "vscode";
+      pid = Number.parseInt(execSync(`ps -o ppid= -p ${pid}`, { stdio: ["pipe", "pipe", "ignore"] }).toString().trim());
+    }
+  } catch {
+  }
+  return null;
+}
+function getMCPConfigPaths(ide, rootDir) {
+  return [
+    {
+      path: join(rootDir, `.${ide}/mcp.json`),
+      displayPath: `.${ide}/mcp.json`
+    },
+    {
+      path: join(homedir(), `.${ide}/mcp.json`),
+      displayPath: `~/.${ide}/mcp.json`
+    }
+  ];
+}
+function findInstalledMCPConfig(ide, rootDir, mcpUrl) {
+  const configPaths = getMCPConfigPaths(ide, rootDir);
+  for (const config of configPaths) {
+    if (existsSync(config.path)) {
+      try {
+        const mcpJson = JSON.parse(readFileSync(config.path, "utf8"));
+        if (isMCPInstalled(mcpJson, mcpUrl)) {
+          return config;
+        }
+      } catch {
+      }
+    }
+  }
+  return null;
+}
+function generateDeeplinkUrl(baseUrl, route, ide, serverName) {
+  const mcpName = `local-${serverName.toLowerCase().replace(/\s+/g, "-")}`;
+  return `${baseUrl}${route}/deeplink?ide=${ide}&name=${encodeURIComponent(mcpName)}`;
+}
 
 const name = "@nuxtjs/mcp-toolkit";
-const version = "0.6.1";
+const version = "0.6.3";
 
 const log = logger.withTag("@nuxtjs/mcp-toolkit");
 const { resolve } = createResolver(import.meta.url);
@@ -26,17 +91,7 @@ const module$1 = defineNuxtModule({
       return;
     }
     const resolver = createResolver(import.meta.url);
-    nuxt.options.runtimeConfig.mcp = defu(
-      nuxt.options.runtimeConfig.mcp,
-      {
-        enabled: options.enabled,
-        route: options.route,
-        browserRedirect: options.browserRedirect,
-        name: options.name,
-        version: options.version,
-        dir: options.dir
-      }
-    );
+    const mcpConfig = getMcpConfig(options);
     if (!options.enabled) {
       return;
     }
@@ -44,7 +99,11 @@ const module$1 = defineNuxtModule({
       name: "InstallButton",
       filePath: resolver.resolve("runtime/components/InstallButton.vue")
     });
-    const mcpDir = options.dir ?? defaultMcpConfig.dir;
+    addServerTemplate({
+      filename: "#nuxt-mcp-toolkit/config.mjs",
+      getContents: () => `export default ${JSON.stringify(mcpConfig)}`
+    });
+    const mcpDir = mcpConfig.dir;
     const paths = {
       tools: [`${mcpDir}/tools`],
       resources: [`${mcpDir}/resources`],
@@ -83,11 +142,17 @@ const module$1 = defineNuxtModule({
       if (!mcpSummary) return;
       const ide = detectIDE();
       if (ide) {
-        const ideName = ide === "cursor" ? "Cursor" : "VS Code";
-        const mcpName = `local-${(options.name || "mcp-server").toLowerCase().replace(/\s+/g, "-")}`;
         const baseUrl = listener.url.replace(/\/$/, "");
-        const deeplinkUrl = `${baseUrl}${options.route}/deeplink?ide=${ide}&name=${encodeURIComponent(mcpName)}`;
-        log.success(`\`${options.route}\` enabled with ${mcpSummary} \xB7 ${terminalLink(`Install local MCP in ${ideName}`, deeplinkUrl)}`);
+        const mcpUrl = `${baseUrl}${options.route}`;
+        const installedConfig = findInstalledMCPConfig(ide, nuxt.options.rootDir, mcpUrl);
+        if (installedConfig) {
+          log.success(`\`${options.route}\` enabled with ${mcpSummary} \xB7 MCP server already installed in \`${installedConfig.displayPath}\``);
+          return;
+        }
+        const ideName = IDE_CONFIGS[ide].name;
+        const deeplinkUrl = generateDeeplinkUrl(baseUrl, options.route, ide, options.name || "mcp-server");
+        log.info(`${ideName} detected. ${terminalLink("Install Nuxt MCP server", deeplinkUrl)}`);
+        log.success(`\`${options.route}\` enabled with ${mcpSummary}`);
       } else {
         log.success(`\`${options.route}\` enabled with ${mcpSummary}`);
       }
@@ -102,12 +167,14 @@ const module$1 = defineNuxtModule({
     nuxt.options.nitro.typescript.tsConfig.include ??= [];
     nuxt.options.nitro.typescript.tsConfig.include.push(resolver.resolve("runtime/server/types.server.d.ts"));
     let isCloudflare = false;
-    nuxt.hook("nitro:config", (nitroConfig) => {
-      const preset = nitroConfig.preset || process.env.NITRO_PRESET || "";
-      isCloudflare = preset.includes("cloudflare");
-    });
+    if (!nuxt.options.dev) {
+      nuxt.hook("nitro:config", (nitroConfig) => {
+        const preset = nitroConfig.preset || process.env.NITRO_PRESET || "";
+        isCloudflare = preset.includes("cloudflare");
+      });
+    }
     addServerTemplate({
-      filename: "#nuxt-mcp/transport.mjs",
+      filename: "#nuxt-mcp-toolkit/transport.mjs",
       getContents: () => {
         const provider = isCloudflare ? "cloudflare" : "node";
         return `export { default } from '${resolver.resolve(`runtime/server/mcp/providers/${provider}`)}'`;
@@ -139,28 +206,5 @@ const module$1 = defineNuxtModule({
     addDevToolsCustomTabs(nuxt, options);
   }
 });
-function terminalLink(text, url) {
-  return `\x1B]8;;${url}\x07${text}\x1B]8;;\x07`;
-}
-function detectIDE() {
-  const env = process.env;
-  if (env.__CFBundleIdentifier === "com.todesktop.230313mzl4w4u92") return "cursor";
-  if (env.__CFBundleIdentifier === "com.microsoft.VSCode") return "vscode";
-  if (env.CURSOR_TRACE_ID) return "cursor";
-  const ipc = env.VSCODE_IPC_HOOK || "";
-  if (ipc.includes("/Cursor/")) return "cursor";
-  if (ipc.includes("/Code/")) return "vscode";
-  try {
-    let pid = process.ppid;
-    for (let i = 0; i < 10 && pid > 1; i++) {
-      const name2 = execSync(`ps -o comm= -p ${pid}`, { stdio: ["pipe", "pipe", "ignore"] }).toString().toLowerCase();
-      if (name2.includes("cursor")) return "cursor";
-      if (name2.includes("code helper") || name2.includes("code.app")) return "vscode";
-      pid = Number.parseInt(execSync(`ps -o ppid= -p ${pid}`, { stdio: ["pipe", "pipe", "ignore"] }).toString().trim());
-    }
-  } catch {
-  }
-  return null;
-}
 
 export { module$1 as default, resolve };

package/dist/runtime/server/mcp/deeplink.js

@@ -1,5 +1,5 @@
 import { defineEventHandler, getRequestURL, getQuery, setHeader } from "h3";
-import { useRuntimeConfig } from "#imports";
+import mcpConfig from "#nuxt-mcp-toolkit/config.mjs";
 const IDE_CONFIGS = {
   cursor: {
     name: "Cursor",
@@ -24,7 +24,6 @@ function escapeJs(str) {
   return str.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/'/g, "\\'").replace(/</g, "\\u003c").replace(/>/g, "\\u003e");
 }
 export default defineEventHandler((event) => {
-  const runtimeConfig = useRuntimeConfig(event).mcp;
   const requestUrl = getRequestURL(event);
   const query = getQuery(event);
   const ide = query.ide || "cursor";
@@ -33,8 +32,8 @@ export default defineEventHandler((event) => {
     setHeader(event, "Location", "/");
     return new Response(null, { status: 302 });
   }
-  const serverName = query.name || runtimeConfig.name || "mcp-server";
-  const mcpUrl = `${requestUrl.origin}${runtimeConfig.route || "/mcp"}`;
+  const serverName = query.name || mcpConfig.name || "mcp-server";
+  const mcpUrl = `${requestUrl.origin}${mcpConfig.route || "/mcp"}`;
   const deeplink = ideConfig.generateDeeplink(serverName, mcpUrl);
   const htmlDeeplink = escapeHtmlAttr(deeplink);
   const jsDeeplink = escapeJs(deeplink);

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

@@ -1,4 +1,5 @@
 import { logger } from "@nuxt/kit";
+import { addCustomTab } from "@nuxt/devtools-kit";
 import { spawn } from "node:child_process";
 const log = logger.withTag("@nuxtjs/mcp-toolkit");
 const INSPECTOR_TIMEOUT = 15e3;
@@ -300,43 +301,41 @@ function stopMcpInspector() {
   }
 }
 export function addDevToolsCustomTabs(nuxt, options) {
-  nuxt.hook("devtools:customTabs", (tabs) => {
-    if (!options.enabled) {
-      return;
-    }
-    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).finally(() => {
-                promise = null;
-              });
-              return promise;
-            }
-          },
-          ...inspectorProcess ? [{
-            label: "Stop Inspector",
-            handle() {
-              stopMcpInspector();
+  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(() => {
               promise = null;
-            }
-          }] : []
-        ]
-      }
-    });
-  });
+            });
+            return promise;
+          }
+        },
+        ...inspectorProcess ? [{
+          label: "Stop Inspector",
+          handle() {
+            stopMcpInspector();
+            promise = null;
+          }
+        }] : []
+      ]
+    }
+  }), nuxt);
   nuxt.hook("close", () => {
     stopMcpInspector();
   });

package/dist/runtime/server/mcp/handler.js

@@ -1,15 +1,12 @@
 import { getRouterParam } from "h3";
-import { useRuntimeConfig } from "#imports";
-import { tools } from "#nuxt-mcp/tools.mjs";
-import { resources } from "#nuxt-mcp/resources.mjs";
-import { prompts } from "#nuxt-mcp/prompts.mjs";
-import { handlers } from "#nuxt-mcp/handlers.mjs";
-import { defaultHandler } from "#nuxt-mcp/default-handler.mjs";
+import config from "#nuxt-mcp-toolkit/config.mjs";
+import { tools } from "#nuxt-mcp-toolkit/tools.mjs";
+import { resources } from "#nuxt-mcp-toolkit/resources.mjs";
+import { prompts } from "#nuxt-mcp-toolkit/prompts.mjs";
+import { handlers } from "#nuxt-mcp-toolkit/handlers.mjs";
+import { defaultHandler } from "#nuxt-mcp-toolkit/default-handler.mjs";
 import { createMcpHandler } from "./utils.js";
-import { getMcpConfig } from "./config.js";
 export default createMcpHandler((event) => {
-  const runtimeConfig = useRuntimeConfig(event).mcp;
-  const config = getMcpConfig(runtimeConfig);
   const handlerName = getRouterParam(event, "handler");
   if (handlerName) {
     const handlerDef = handlers.find(

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

@@ -37,7 +37,7 @@ async function loadHandlers(paths = []) {
   try {
     if (paths.length === 0) {
       addServerTemplate({
-        filename: "#nuxt-mcp/handlers.mjs",
+        filename: "#nuxt-mcp-toolkit/handlers.mjs",
         getContents: () => `export const handlers = []
 `
       });
@@ -54,7 +54,7 @@ async function loadHandlers(paths = []) {
       }
     });
     addServerTemplate({
-      filename: "#nuxt-mcp/handlers.mjs",
+      filename: "#nuxt-mcp-toolkit/handlers.mjs",
       getContents: () => {
         if (result.count === 0) {
           return `export const handlers = []
@@ -77,20 +77,20 @@ async function loadHandlers(paths = []) {
   }
 }
 export async function loadTools(paths) {
-  return loadMcpDefinitions("tools", "#nuxt-mcp/tools.mjs", paths);
+  return loadMcpDefinitions("tools", "#nuxt-mcp-toolkit/tools.mjs", paths);
 }
 export async function loadResources(paths) {
-  return loadMcpDefinitions("resources", "#nuxt-mcp/resources.mjs", paths);
+  return loadMcpDefinitions("resources", "#nuxt-mcp-toolkit/resources.mjs", paths);
 }
 export async function loadPrompts(paths) {
-  return loadMcpDefinitions("prompts", "#nuxt-mcp/prompts.mjs", paths);
+  return loadMcpDefinitions("prompts", "#nuxt-mcp-toolkit/prompts.mjs", paths);
 }
 export { loadHandlers };
 async function loadDefaultHandler(paths = []) {
   try {
     const indexFile = await findIndexFile(paths);
     addServerTemplate({
-      filename: "#nuxt-mcp/default-handler.mjs",
+      filename: "#nuxt-mcp-toolkit/default-handler.mjs",
       getContents: () => {
         if (!indexFile) {
           return `export const defaultHandler = null
@@ -106,7 +106,7 @@ export const defaultHandler = handler
     const errorMessage = error instanceof Error ? error.message : String(error);
     log.error(`Failed to load default handler: ${errorMessage}`);
     addServerTemplate({
-      filename: "#nuxt-mcp/default-handler.mjs",
+      filename: "#nuxt-mcp-toolkit/default-handler.mjs",
       getContents: () => `export const defaultHandler = null
 `
     });
@@ -142,7 +142,7 @@ export async function loadAllDefinitions(paths) {
 }
 export async function getHandlerRoutes() {
   try {
-    const handlersModule = await import("#nuxt-mcp/handlers.mjs");
+    const handlersModule = await import("#nuxt-mcp-toolkit/handlers.mjs");
     const handlers = handlersModule.handlers;
     return handlers.map((h) => ({ name: h.name, route: h.route }));
   } catch {

package/dist/runtime/server/mcp/providers/cloudflare.js

@@ -1,4 +1,3 @@
-import { createMcpHandler } from "agents/mcp";
 import { toWebRequest } from "h3";
 import { createMcpTransportHandler } from "./types.js";
 const fallbackCtx = {
@@ -7,8 +6,12 @@ const fallbackCtx = {
   passThroughOnException: () => {
   }
 };
-export default createMcpTransportHandler((server, event) => {
-  const handler = createMcpHandler(server);
+export default createMcpTransportHandler(async (server, event) => {
+  const { createMcpHandler } = await import("agents/mcp");
+  const handler = createMcpHandler(server, {
+    route: ""
+    // allow any route
+  });
   const request = toWebRequest(event);
   const cf = event.context.cloudflare;
   return handler(request, cf?.env ?? {}, cf?.ctx ?? fallbackCtx);

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

@@ -1,7 +1,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { sendRedirect, getHeader, defineEventHandler } from "h3";
 import { registerToolFromDefinition, registerResourceFromDefinition, registerPromptFromDefinition } from "./definitions/index.js";
-import handleMcpRequest from "#nuxt-mcp/transport.mjs";
+import handleMcpRequest from "#nuxt-mcp-toolkit/transport.mjs";
 export { createMcpTransportHandler } from "./providers/types.js";
 function resolveConfig(config, event) {
   return typeof config === "function" ? config(event) : config;

package/dist/runtime/server/types.server.d.ts

@@ -1,19 +1,26 @@
 import type { McpToolDefinition, McpResourceDefinition, McpPromptDefinition } from './mcp/definitions'
 import './types/hooks'
 
-declare module '#nuxt-mcp/tools.mjs' {
+declare module '#nuxt-mcp-toolkit/tools.mjs' {
   export const tools: McpToolDefinition[]
 }
 
-declare module '#nuxt-mcp/resources.mjs' {
+declare module '#nuxt-mcp-toolkit/resources.mjs' {
   export const resources: McpResourceDefinition[]
 }
 
-declare module '#nuxt-mcp/prompts.mjs' {
+declare module '#nuxt-mcp-toolkit/prompts.mjs' {
   export const prompts: McpPromptDefinition[]
 }
 
-declare module '#nuxt-mcp/transport.mjs' {
+declare module '#nuxt-mcp-toolkit/config.mjs' {
+  import type { McpConfig } from './mcp/config'
+
+  const config: McpConfig
+  export default config
+}
+
+declare module '#nuxt-mcp-toolkit/transport.mjs' {
   import type { McpTransportHandler } from './mcp/providers/types'
 
   const handleMcpRequest: McpTransportHandler

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxtjs/mcp-toolkit",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Create MCP servers directly in your Nuxt application. Define tools, resources, and prompts with a simple and intuitive API.",
   "repository": {
     "type": "git",
@@ -17,6 +17,10 @@
     ".": {
       "types": "./dist/types.d.mts",
       "import": "./dist/module.mjs"
+    },
+    "./server": {
+      "types": "./dist/runtime/server/mcp/definitions/index.d.ts",
+      "import": "./dist/runtime/server/mcp/definitions/index.js"
     }
   },
   "main": "./dist/module.mjs",
@@ -24,6 +28,9 @@
     "*": {
       ".": [
         "./dist/types.d.mts"
+      ],
+      "server": [
+        "./dist/runtime/server/mcp/definitions/index.d.ts"
       ]
     }
   },
@@ -32,21 +39,18 @@
     "dist"
   ],
   "dependencies": {
-    "@clack/prompts": "^0.11.0",
-    "@modelcontextprotocol/sdk": "^1.25.1",
-    "@nuxt/kit": "^4.2.2",
-    "automd": "^0.4.2",
-    "chokidar": "^5.0.0",
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "@nuxt/kit": "^4.3.0",
     "defu": "^6.1.4",
     "ms": "^2.1.3",
     "pathe": "^2.0.3",
-    "satori": "^0.18.3",
+    "satori": "^0.19.1",
     "scule": "^1.3.0",
     "tinyglobby": "^0.2.15"
   },
   "peerDependencies": {
     "zod": "^4.1.13",
-    "agents": ">=0.3.3"
+    "agents": ">=0.3.6"
   },
   "peerDependenciesMeta": {
     "zod": {
@@ -58,17 +62,17 @@
   },
   "devDependencies": {
     "@nuxt/devtools": "^3.1.1",
-    "@nuxt/eslint-config": "^1.12.1",
+    "@nuxt/eslint-config": "^1.13.0",
     "@nuxt/module-builder": "^1.0.2",
-    "@nuxt/schema": "^4.2.2",
-    "@nuxt/test-utils": "^3.21.0",
+    "@nuxt/schema": "^4.3.0",
+    "@nuxt/test-utils": "^3.23.0",
     "@types/node": "latest",
     "changelogen": "^0.6.2",
     "eslint": "^9.39.2",
-    "nuxt": "^4.2.2",
+    "nuxt": "^4.3.0",
     "typescript": "~5.9.3",
-    "vitest": "^4.0.16",
-    "vue-tsc": "^3.2.1"
+    "vitest": "^4.0.18",
+    "vue-tsc": "^3.2.4"
   },
   "publishConfig": {
     "access": "public"