@xiaou66/vite-plugin-vue-mcp-next 1.0.0 → 1.0.1

package/dist/index.d.cts

@@ -29,9 +29,9 @@ interface VueMcpNextOptions {
     readonly host?: string;
     /** 是否在 Vite 启动日志中打印 MCP 地址，默认开启方便开发者复制到 MCP 客户端。 */
     readonly printUrl?: boolean;
-    /** 是否写入 Cursor MCP 配置；只在 `.cursor` 已存在时生效，避免擅自创建编辑器配置目录。 */
+    /** 是否写入 Cursor MCP 配置；默认只在 `.cursor` 已存在时写入，显式 `true` 会创建配置。 */
     readonly updateCursorMcpJson?: boolean | CursorMcpConfig;
-    /** 是否写入常见 AI 客户端的项目级 MCP 配置，默认启用 Cursor、Codex、Claude Code 和 Trae。 */
+    /** 是否写入常见 AI 客户端的项目级 MCP 配置；默认按项目已有客户端入口自动探测。 */
     readonly mcpClients?: McpClientConfigOptions;
     /** 非 HTML 入口的运行时脚本注入点，用于兼容不直接使用 `index.html` 的项目。 */
     readonly appendTo?: string | RegExp;
@@ -54,7 +54,7 @@ interface VueMcpNextOptions {
  * 该配置只负责本地开发体验，不应强行修改未启用 Cursor 的项目。
  */
 interface CursorMcpConfig {
-    /** 是否启用 Cursor 配置写入，适合团队项目显式关闭自动改配置。 */
+    /** 是否启用 Cursor 配置写入；显式启用会创建 `.cursor/mcp.json`，显式关闭会跳过。 */
     readonly enabled: boolean;
     /** Cursor 展示的 MCP 服务名，用于同一项目存在多个 MCP 服务时避免冲突。 */
     readonly serverName?: string;
@@ -66,13 +66,13 @@ interface CursorMcpConfig {
  * 集中配置可以避免为每个客户端暴露一组重复选项。
  */
 interface McpClientConfigOptions {
-    /** 是否写入 Cursor 的 `.cursor/mcp.json`，适合 Cursor 用户开箱即用。 */
+    /** 是否写入 Cursor 的 `.cursor/mcp.json`；默认只在 `.cursor` 目录已存在时自动写入。 */
     readonly cursor?: boolean;
-    /** 是否写入 Codex 的 `.codex/config.toml`，适合 Codex 项目级 MCP 配置。 */
+    /** 是否写入 Codex 的 `.codex/config.toml`；默认只在 `.codex` 目录已存在时自动写入。 */
     readonly codex?: boolean;
-    /** 是否写入 Claude Code 的 `.mcp.json`，采用官方项目级 MCP 配置入口。 */
+    /** 是否写入 Claude Code 的 `.mcp.json`；默认只在根目录 `.mcp.json` 已存在时自动写入。 */
     readonly claudeCode?: boolean;
-    /** 是否写入 Trae 的 `.trae/mcp.json`，与 Trae 项目级 MCP 文档保持一致。 */
+    /** 是否写入 Trae 的 `.trae/mcp.json`；默认只在 `.trae` 目录已存在时自动写入。 */
     readonly trae?: boolean;
     /** MCP 客户端中展示的服务名，同一项目存在多个 MCP 服务时用于避免冲突。 */
     readonly serverName?: string;

package/dist/index.d.ts

@@ -29,9 +29,9 @@ interface VueMcpNextOptions {
     readonly host?: string;
     /** 是否在 Vite 启动日志中打印 MCP 地址，默认开启方便开发者复制到 MCP 客户端。 */
     readonly printUrl?: boolean;
-    /** 是否写入 Cursor MCP 配置；只在 `.cursor` 已存在时生效，避免擅自创建编辑器配置目录。 */
+    /** 是否写入 Cursor MCP 配置；默认只在 `.cursor` 已存在时写入，显式 `true` 会创建配置。 */
     readonly updateCursorMcpJson?: boolean | CursorMcpConfig;
-    /** 是否写入常见 AI 客户端的项目级 MCP 配置，默认启用 Cursor、Codex、Claude Code 和 Trae。 */
+    /** 是否写入常见 AI 客户端的项目级 MCP 配置；默认按项目已有客户端入口自动探测。 */
     readonly mcpClients?: McpClientConfigOptions;
     /** 非 HTML 入口的运行时脚本注入点，用于兼容不直接使用 `index.html` 的项目。 */
     readonly appendTo?: string | RegExp;
@@ -54,7 +54,7 @@ interface VueMcpNextOptions {
  * 该配置只负责本地开发体验，不应强行修改未启用 Cursor 的项目。
  */
 interface CursorMcpConfig {
-    /** 是否启用 Cursor 配置写入，适合团队项目显式关闭自动改配置。 */
+    /** 是否启用 Cursor 配置写入；显式启用会创建 `.cursor/mcp.json`，显式关闭会跳过。 */
     readonly enabled: boolean;
     /** Cursor 展示的 MCP 服务名，用于同一项目存在多个 MCP 服务时避免冲突。 */
     readonly serverName?: string;
@@ -66,13 +66,13 @@ interface CursorMcpConfig {
  * 集中配置可以避免为每个客户端暴露一组重复选项。
  */
 interface McpClientConfigOptions {
-    /** 是否写入 Cursor 的 `.cursor/mcp.json`，适合 Cursor 用户开箱即用。 */
+    /** 是否写入 Cursor 的 `.cursor/mcp.json`；默认只在 `.cursor` 目录已存在时自动写入。 */
     readonly cursor?: boolean;
-    /** 是否写入 Codex 的 `.codex/config.toml`，适合 Codex 项目级 MCP 配置。 */
+    /** 是否写入 Codex 的 `.codex/config.toml`；默认只在 `.codex` 目录已存在时自动写入。 */
     readonly codex?: boolean;
-    /** 是否写入 Claude Code 的 `.mcp.json`，采用官方项目级 MCP 配置入口。 */
+    /** 是否写入 Claude Code 的 `.mcp.json`；默认只在根目录 `.mcp.json` 已存在时自动写入。 */
     readonly claudeCode?: boolean;
-    /** 是否写入 Trae 的 `.trae/mcp.json`，与 Trae 项目级 MCP 文档保持一致。 */
+    /** 是否写入 Trae 的 `.trae/mcp.json`；默认只在 `.trae` 目录已存在时自动写入。 */
     readonly trae?: boolean;
     /** MCP 客户端中展示的服务名，同一项目存在多个 MCP 服务时用于避免冲突。 */
     readonly serverName?: string;

package/dist/index.js

@@ -1734,6 +1734,7 @@ function getPluginPath(plugin) {
 }
 
 // src/plugin/mcpClientConfig/index.ts
+import fs4 from "fs/promises";
 import path5 from "path";
 
 // src/plugin/mcpClientConfig/codexConfig.ts
@@ -1870,10 +1871,17 @@ function isNodeError2(error) {
 }
 
 // src/plugin/mcpClientConfig/index.ts
-async function updateMcpClientConfigs(root, sseUrl, streamableHttpUrl, options) {
+async function updateMcpClientConfigs(root, sseUrl, streamableHttpUrl, options, userOptions = {}) {
   const serverName = options.serverName;
   const jobs = [];
-  if (options.cursor) {
+  if (await shouldUpdateClientConfig({
+    root,
+    clientName: "cursor",
+    enabled: options.cursor,
+    entryPath: path5.join(root, ".cursor"),
+    entryKind: "directory",
+    userOptions
+  })) {
     jobs.push(
       updateJsonMcpClientConfig({
         clientName: "Cursor",
@@ -1883,7 +1891,14 @@ async function updateMcpClientConfigs(root, sseUrl, streamableHttpUrl, options)
       })
     );
   }
-  if (options.codex) {
+  if (await shouldUpdateClientConfig({
+    root,
+    clientName: "codex",
+    enabled: options.codex,
+    entryPath: path5.join(root, ".codex"),
+    entryKind: "directory",
+    userOptions
+  })) {
     jobs.push(
       updateCodexMcpClientConfig({
         configPath: path5.join(root, ".codex", "config.toml"),
@@ -1892,7 +1907,14 @@ async function updateMcpClientConfigs(root, sseUrl, streamableHttpUrl, options)
       })
     );
   }
-  if (options.claudeCode) {
+  if (await shouldUpdateClientConfig({
+    root,
+    clientName: "claudeCode",
+    enabled: options.claudeCode,
+    entryPath: path5.join(root, ".mcp.json"),
+    entryKind: "file",
+    userOptions
+  })) {
     jobs.push(
       updateJsonMcpClientConfig({
         clientName: "Claude Code",
@@ -1902,7 +1924,14 @@ async function updateMcpClientConfigs(root, sseUrl, streamableHttpUrl, options)
       })
     );
   }
-  if (options.trae) {
+  if (await shouldUpdateClientConfig({
+    root,
+    clientName: "trae",
+    enabled: options.trae,
+    entryPath: path5.join(root, ".trae"),
+    entryKind: "directory",
+    userOptions
+  })) {
     jobs.push(
       updateJsonMcpClientConfig({
         clientName: "Trae",
@@ -1914,6 +1943,41 @@ async function updateMcpClientConfigs(root, sseUrl, streamableHttpUrl, options)
   }
   await Promise.all(jobs);
 }
+async function shouldUpdateClientConfig(options) {
+  if (!options.enabled) {
+    return false;
+  }
+  if (isClientExplicitlyConfigured(options.clientName, options.userOptions)) {
+    return true;
+  }
+  return hasExpectedEntry(options.entryPath, options.entryKind);
+}
+function isClientExplicitlyConfigured(clientName, userOptions) {
+  if (Object.hasOwn(userOptions.mcpClients ?? {}, clientName)) {
+    return true;
+  }
+  return clientName === "cursor" && userOptions.updateCursorMcpJson !== void 0;
+}
+async function hasExpectedEntry(entryPath, entryKind) {
+  try {
+    const stat = await fs4.stat(entryPath);
+    return entryKind === "directory" ? stat.isDirectory() : stat.isFile();
+  } catch (error) {
+    if (isNodeError3(error) && error.code === "ENOENT") {
+      return false;
+    }
+    console.warn(
+      `[vite-plugin-vue-mcp-next] Failed to inspect MCP client entry at ${entryPath}: ${formatError3(error)}`
+    );
+    return false;
+  }
+}
+function formatError3(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function isNodeError3(error) {
+  return error instanceof Error && "code" in error;
+}
 
 // src/plugin/createPlugin.ts
 import { createRPCServer } from "vite-dev-rpc";
@@ -1983,7 +2047,8 @@ function vueMcpNext(userOptions = {}) {
         root,
         mcpSseUrl,
         mcpStreamableHttpUrl,
-        options.mcpClients
+        options.mcpClients,
+        userOptions
       );
       if (options.printUrl) {
         setTimeout(() => {