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

package/README.md

@@ -43,14 +43,18 @@ SSE: http://localhost:<vite-port>/__mcp/sse
 Streamable HTTP: http://localhost:<vite-port>/__mcp/mcp
 ```
 
-启动 Vite dev server 后，插件会自动写入常见 AI 客户端的项目级 MCP 配置，服务名默认是 `vue-mcp-next`。自动配置只会在缺少同名 server 条目时新增配置；如果用户已经配置了 `vue-mcp-next`，插件不会重复写入或覆盖原配置。
+启动 Vite dev server 后，插件会按项目中已经存在的客户端入口自动写入项目级 MCP 配置，服务名默认是 `vue-mcp-next`。自动配置只会在缺少同名 server 条目时新增配置；如果用户已经配置了 `vue-mcp-next`，插件不会重复写入、覆盖原配置或改写用户自定义字段。
 
-| 客户端      | 自动配置文件         | 默认端点        |
-| ----------- | -------------------- | --------------- |
-| Cursor      | `.cursor/mcp.json`   | SSE             |
-| Codex       | `.codex/config.toml` | Streamable HTTP |
-| Claude Code | `.mcp.json`          | SSE             |
-| Trae        | `.trae/mcp.json`     | SSE             |
+默认自动探测规则如下：
+
+| 客户端      | 自动探测入口 | 自动配置文件         | 默认端点        |
+| ----------- | ------------ | -------------------- | --------------- |
+| Cursor      | `.cursor/`   | `.cursor/mcp.json`   | SSE             |
+| Codex       | `.codex/`    | `.codex/config.toml` | Streamable HTTP |
+| Claude Code | `.mcp.json`  | `.mcp.json`          | SSE             |
+| Trae        | `.trae/`     | `.trae/mcp.json`     | SSE             |
+
+如果项目中没有对应入口，默认不会创建该客户端配置。需要强制创建时，可以在 `mcpClients` 中显式设置对应客户端为 `true`；需要禁用时显式设置为 `false`。
 
 实际端口以启动日志中的 `MCP: SSE server is running at ...` 和 `MCP: Streamable HTTP server is running at ...` 为准。
 
@@ -82,6 +86,8 @@ url = "http://localhost:5173/__mcp/mcp"
 
 ## 完整配置
 
+`mcpClients` 中的布尔值保留为开关语义：默认解析后为 `true`，但写入阶段会先做项目入口自动探测；用户在配置中显式写出 `true` 时表示强制创建对应客户端配置。
+
 ```ts
 vueMcpNext({
   mcpPath: '/__mcp',
@@ -147,8 +153,8 @@ vueMcpNext({
 | `mcpPath`             | `string`                                                                                           | `'/__mcp'`               | MCP 服务挂载路径，实际 SSE 地址是 `${mcpPath}/sse`，Streamable HTTP 地址是 `${mcpPath}/mcp` |
 | `host`                | `string`                                                                                           | `'localhost'`            | 打印 MCP 地址和写入 MCP 客户端配置时使用的 host                                             |
 | `printUrl`            | `boolean`                                                                                          | `true`                   | 是否在 Vite 启动日志中打印 MCP SSE 地址                                                     |
-| `mcpClients`          | `{ cursor?: boolean; codex?: boolean; claudeCode?: boolean; trae?: boolean; serverName?: string }` | 全部启用                 | 是否自动写入 Cursor、Codex、Claude Code、Trae 的项目级 MCP 配置                             |
-| `updateCursorMcpJson` | `boolean \| { enabled: boolean; serverName?: string }`                                             | `true`                   | 兼容旧配置，建议新项目使用 `mcpClients`                                                     |
+| `mcpClients`          | `{ cursor?: boolean; codex?: boolean; claudeCode?: boolean; trae?: boolean; serverName?: string }` | 自动探测                 | 是否写入 Cursor、Codex、Claude Code、Trae 的项目级 MCP 配置；默认只处理项目中已有入口，显式 `true` 强制创建 |
+| `updateCursorMcpJson` | `boolean \| { enabled: boolean; serverName?: string }`                                             | 自动探测                 | 兼容旧配置；默认只在 `.cursor` 已存在时写入，建议新项目使用 `mcpClients`                           |
 | `appendTo`            | `string \| RegExp`                                                                                 | `undefined`              | 非 HTML 入口注入点。配置后会在匹配入口模块前追加 runtime import                             |
 | `screenshot`          | `ScreenshotOptions`                                                                                | CDP 优先，snapdom 降级   | 页面截图配置，控制真截图、DOM 降级截图、体积上限和 snapdom 扩展                             |
 | `screenshot.type`     | `'path' \| 'base64'`                                                                               | `'path'`                 | 项目级控制截图返回文件路径还是 base64 数据                                                  |
@@ -362,7 +368,6 @@ export function createMaskPlugin(options: { selectors: string[] }) {
 | ---------------- | ------------------------- | ------------------------------- | ----------------------------------------------------------------- |
 | `list_pages`     | 无                        | `entries`、`pages`、`cdpError?` | 返回 Vite HTML 入口、runtime 页面和 CDP target                    |
 | `reload_page`    | `pageId?`、`ignoreCache?` | `ok`、`source`、`ignoreCache?`  | 刷新目标页面；CDP 可用时使用无缓存刷新，Runtime Hook 只能普通刷新 |
-| `get_page_state` | `pageId?`                 | 页面状态                        | 预留页面状态工具名                                                |
 
 `list_pages` 的 `pages` 中可能出现两类页面：
 

package/dist/index.cjs

@@ -58,7 +58,6 @@ var DEFAULT_SCREENSHOT_SAVE_DIR = ".vite-mcp/screenshot";
 var MCP_TOOL_NAMES = {
   listPages: "list_pages",
   reloadPage: "reload_page",
-  getPageState: "get_page_state",
   getDomTree: "get_dom_tree",
   queryDom: "query_dom",
   takeScreenshot: "take_screenshot",
@@ -1772,6 +1771,7 @@ function getPluginPath(plugin) {
 }
 
 // src/plugin/mcpClientConfig/index.ts
+var import_promises4 = __toESM(require("fs/promises"), 1);
 var import_node_path6 = __toESM(require("path"), 1);
 
 // src/plugin/mcpClientConfig/codexConfig.ts
@@ -1908,10 +1908,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: import_node_path6.default.join(root, ".cursor"),
+    entryKind: "directory",
+    userOptions
+  })) {
     jobs.push(
       updateJsonMcpClientConfig({
         clientName: "Cursor",
@@ -1921,7 +1928,14 @@ async function updateMcpClientConfigs(root, sseUrl, streamableHttpUrl, options)
       })
     );
   }
-  if (options.codex) {
+  if (await shouldUpdateClientConfig({
+    root,
+    clientName: "codex",
+    enabled: options.codex,
+    entryPath: import_node_path6.default.join(root, ".codex"),
+    entryKind: "directory",
+    userOptions
+  })) {
     jobs.push(
       updateCodexMcpClientConfig({
         configPath: import_node_path6.default.join(root, ".codex", "config.toml"),
@@ -1930,7 +1944,14 @@ async function updateMcpClientConfigs(root, sseUrl, streamableHttpUrl, options)
       })
     );
   }
-  if (options.claudeCode) {
+  if (await shouldUpdateClientConfig({
+    root,
+    clientName: "claudeCode",
+    enabled: options.claudeCode,
+    entryPath: import_node_path6.default.join(root, ".mcp.json"),
+    entryKind: "file",
+    userOptions
+  })) {
     jobs.push(
       updateJsonMcpClientConfig({
         clientName: "Claude Code",
@@ -1940,7 +1961,14 @@ async function updateMcpClientConfigs(root, sseUrl, streamableHttpUrl, options)
       })
     );
   }
-  if (options.trae) {
+  if (await shouldUpdateClientConfig({
+    root,
+    clientName: "trae",
+    enabled: options.trae,
+    entryPath: import_node_path6.default.join(root, ".trae"),
+    entryKind: "directory",
+    userOptions
+  })) {
     jobs.push(
       updateJsonMcpClientConfig({
         clientName: "Trae",
@@ -1952,6 +1980,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 import_promises4.default.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
 var import_vite_dev_rpc = require("vite-dev-rpc");
@@ -2021,7 +2084,8 @@ function vueMcpNext(userOptions = {}) {
         root,
         mcpSseUrl,
         mcpStreamableHttpUrl,
-        options.mcpClients
+        options.mcpClients,
+        userOptions
       );
       if (options.printUrl) {
         setTimeout(() => {