@weapp-vite/mcp 2.1.0 → 2.2.0

package/README.md

@@ -19,7 +19,7 @@
 
 ## 启动
 
-直接使用 `@weapp-vite/mcp` 或 `@weapp-vite/acceptance` 需要 **Node.js >=22.12.0**。这两个包不再支持 Node 20；通过 `weapp-vite` 命令使用时，还须满足 `weapp-vite` 自身的 Node 范围 `^22.18.0 || ^24.11.0 || >=26.0.0`。
+直接使用 `@weapp-vite/mcp`、`@weapp-vite/acceptance` 或通过 `weapp-vite` 命令使用时，均需满足 Node.js 范围 `^22.23.4 || ^24.22.1 || >=26.12.1`。
 
 ```bash
 pnpm --filter @weapp-vite/mcp start

package/dist/index.d.ts

@@ -5,7 +5,6 @@ import { z } from "zod";
 import { DevtoolsRuntimeHooks } from "@weapp-vite/devtools-runtime";
 import { Buffer } from "node:buffer";
 import { WechatDevtoolsSelectionOptions } from "weapp-ide-cli";
-//#region src/server/runtime/shared.d.ts
 interface MiniProgramElement {
   tagName?: string;
   $?: (selector: string) => Promise<MiniProgramElement | null>;
@@ -92,12 +91,8 @@ declare class RuntimeSessionManager {
   private detach;
   private pushLog;
 }
-//#endregion
-//#region src/acceptance.d.ts
 export declare function acceptanceRuntime(parent: RuntimeSessionManager): RuntimeConnector;
 export declare function createRuntimeAcceptanceService(root: string, options?: AcceptanceOptions, hooks?: DevtoolsRuntimeHooks): Promise<AcceptanceService>;
-//#endregion
-//#region src/constants.d.ts
 export declare const MCP_SERVER_NAME = "@weapp-vite/mcp";
 export declare const MCP_SERVER_VERSION: string;
 export declare const EXPOSED_PACKAGES: {
@@ -126,8 +121,6 @@ export declare const DEFAULT_MAX_OUTPUT_CHARS = 120000;
 export declare const DEFAULT_MAX_FILE_CHARS = 80000;
 export declare const DEFAULT_MAX_RESULTS = 200;
 export declare const SKIPPED_DIR_NAMES: Set<string>;
-//#endregion
-//#region src/exposedPackages.d.ts
 interface ResolvedExposedPackage {
   id: ExposedPackageId;
   label: string;
@@ -143,13 +136,9 @@ interface ResolvedExposedPackage {
   sourceRoot?: string;
   cliPath?: string;
 }
-//#endregion
-//#region src/catalog.d.ts
 export interface ExposedPackageSummary extends ResolvedExposedPackage {}
 export declare function loadPackageSummary(workspaceRoot: string, id: ExposedPackageId): Promise<ExposedPackageSummary>;
 export declare function loadExposedCatalog(workspaceRoot: string): Promise<ResolvedExposedPackage[]>;
-//#endregion
-//#region src/commandOps.d.ts
 export interface CommandResult {
   command: string;
   args: string[];
@@ -164,8 +153,6 @@ export declare function runCommand(workspaceRoot: string, command: string, args:
   timeoutMs?: number;
   maxOutputChars?: number;
 }): Promise<CommandResult>;
-//#endregion
-//#region src/fileOps.d.ts
 export interface SearchMatch {
   filePath: string;
   line: number;
@@ -185,8 +172,6 @@ export declare function searchTextInDirectory(root: string, query: string, optio
   relativeDirectory?: string;
   maxResults?: number;
 }): Promise<SearchMatch[]>;
-//#endregion
-//#region src/server/index.d.ts
 export interface CreateServerOptions {
   runtimeHooks?: DevtoolsRuntimeHooks;
   workspaceRoot?: string;
@@ -204,8 +189,6 @@ export declare function createWeappViteMcpServer(options?: CreateServerOptions):
   server: McpServer;
   workspaceRoot: string;
 }>;
-//#endregion
-//#region src/runtime.d.ts
 export interface StartMcpServerOptions extends CreateServerOptions {
   transport?: 'stdio' | 'streamable-http';
   host?: string;
@@ -222,11 +205,7 @@ export interface McpServerHandle {
 }
 export declare function startStdioServer(options?: CreateServerOptions): Promise<McpServerHandle>;
 export declare function startWeappViteMcpServer(options?: StartMcpServerOptions): Promise<McpServerHandle>;
-//#endregion
-//#region src/server/acceptance.d.ts
 export declare function registerAcceptanceTools(server: McpServer, service: () => Promise<AcceptanceService>): McpServer;
-//#endregion
-//#region src/utils.d.ts
 export declare function formatJson(value: unknown): string;
 export declare function normalizeErrorMessage(error: unknown): string;
 export declare function toToolResult(data: unknown, text?: string): {
@@ -245,10 +224,7 @@ export declare function toToolError(error: unknown): {
     text: string;
   }[];
 };
-//#endregion
-//#region src/workspace.d.ts
 export declare function resolveWorkspaceRoot(start?: string): string;
 export declare function assertInsideRoot(root: string, targetPath: string): string;
 export declare function resolveSubPath(root: string, relativePath: string): string;
-//#endregion
 export { DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_RUNTIME_REST_ENDPOINT };

package/dist/index.mjs

@@ -14,7 +14,7 @@ import { acquireRuntimeLease, acquireSharedMiniProgram, closeOwnedSharedMiniProg
 import fs$1 from "node:fs/promises";
 import { Buffer } from "node:buffer";
 import { spawn } from "node:child_process";
-//#region src/utils.ts
+// src/utils.ts
 function formatJson(value) {
 	return JSON.stringify(value, null, 2);
 }
@@ -40,8 +40,7 @@ function toToolError(error) {
 		}]
 	};
 }
-//#endregion
-//#region src/server/runtime/shared.ts
+// src/server/runtime/shared.ts
 const DEFAULT_SCREENSHOT_TIMEOUT = 6e4;
 const SCREENSHOT_RETRY_DELAY = 500;
 const connectionSchema$1 = z.object({
@@ -487,8 +486,7 @@ function createUnavailableRuntimeHooks() {
 		throw new Error("未配置 DevTools runtime hooks。请通过 createWeappViteMcpServer({ runtimeHooks }) 注入 automator 连接能力。");
 	} };
 }
-//#endregion
-//#region src/server/runtime/devtools.ts
+// src/server/runtime/devtools.ts
 const navigateSchema = {
 	...connectionInputSchema,
 	path: z.string().trim().min(1).optional(),
@@ -683,8 +681,7 @@ function registerDevtoolsRuntimeTools(server, manager) {
 		}
 	});
 }
-//#endregion
-//#region src/server/runtime/runtimeNode.ts
+// src/server/runtime/runtimeNode.ts
 const elementSelectorSchema = {
 	...connectionInputSchema,
 	selector: z.string().trim().min(1),
@@ -983,8 +980,7 @@ function toRecord(value) {
 function toNumber(value) {
 	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
-//#endregion
-//#region src/server/runtime/runtimePage.ts
+// src/server/runtime/runtimePage.ts
 const selectorSchema = {
 	...connectionInputSchema,
 	selector: z.string().trim().min(1),
@@ -1186,8 +1182,7 @@ function registerRuntimePageTools(server, manager) {
 		}
 	});
 }
-//#endregion
-//#region src/server/runtime/index.ts
+// src/server/runtime/index.ts
 function registerRuntimeTools(server, options) {
 	const manager = options.manager ?? new RuntimeSessionManager(options.workspaceRoot, options.runtimeHooks);
 	registerDevtoolsRuntimeTools(server, manager);
@@ -1195,8 +1190,7 @@ function registerRuntimeTools(server, options) {
 	registerRuntimeNodeTools(server, manager);
 	return manager;
 }
-//#endregion
-//#region src/acceptance.ts
+// src/acceptance.ts
 function acceptanceRuntime(parent) {
 	return async (_server, context) => {
 		const lease = await acquireRuntimeLease(context.root);
@@ -1280,11 +1274,9 @@ async function createRuntimeAcceptanceService(root, options = {}, hooks) {
 	};
 	return service;
 }
-//#endregion
-//#region package.json
-var version = "2.1.0";
-//#endregion
-//#region src/constants.ts
+// package.json
+var version = "2.2.0";
+// src/constants.ts
 const MCP_SERVER_NAME = "@weapp-vite/mcp";
 const MCP_SERVER_VERSION = version;
 const EXPOSED_PACKAGES = {
@@ -1318,8 +1310,7 @@ const SKIPPED_DIR_NAMES = /* @__PURE__ */ new Set([
 	"dist",
 	"coverage"
 ]);
-//#endregion
-//#region src/workspace.ts
+// src/workspace.ts
 function hasWorkspaceMarkers(dir) {
 	return fs.existsSync(path.join(dir, "pnpm-workspace.yaml")) && fs.existsSync(path.join(dir, "package.json"));
 }
@@ -1345,8 +1336,7 @@ function resolveSubPath(root, relativePath) {
 	if (path.isAbsolute(relativePath)) throw new Error("仅支持相对路径");
 	return assertInsideRoot(root, path.resolve(root, relativePath));
 }
-//#endregion
-//#region src/exposedPackages.ts
+// src/exposedPackages.ts
 async function pathExists(filePath) {
 	try {
 		await fs$1.access(filePath);
@@ -1443,8 +1433,7 @@ async function resolveExposedPackages(workspaceRoot) {
 		return [];
 	}).sort((a, b) => a.id.localeCompare(b.id));
 }
-//#endregion
-//#region src/server/acceptance.ts
+// src/server/acceptance.ts
 function registerAcceptanceTools(server, service) {
 	const json = (data) => {
 		const structuredContent = redactValue(data);
@@ -1547,8 +1536,7 @@ function registerAcceptanceTools(server, service) {
 	}));
 	return server;
 }
-//#endregion
-//#region src/server/prompts.ts
+// src/server/prompts.ts
 function registerServerPrompts(server, options) {
 	const { packageIds, packageIdSchema } = options;
 	server.registerPrompt("plan-weapp-vite-change", {
@@ -1642,8 +1630,7 @@ function registerServerPrompts(server, options) {
 		}] };
 	});
 }
-//#endregion
-//#region src/fileOps.ts
+// src/fileOps.ts
 async function walkFilesRecursive(root, current, output, maxResults) {
 	if (output.length >= maxResults) return;
 	const entries = await fs$1.readdir(current, { withFileTypes: true });
@@ -1714,8 +1701,7 @@ async function searchTextInDirectory(root, query, options) {
 	}
 	return matches;
 }
-//#endregion
-//#region src/commandOps.ts
+// src/commandOps.ts
 const ALLOWED_COMMANDS = /* @__PURE__ */ new Set([
 	"pnpm",
 	"node",
@@ -1781,8 +1767,7 @@ async function runCommand(workspaceRoot, command, args, options) {
 		timedOut
 	};
 }
-//#endregion
-//#region src/server/shared.ts
+// src/server/shared.ts
 async function resolvePackageRoot(workspaceRoot, packageId) {
 	const resolved = await resolveExposedPackage(workspaceRoot, packageId);
 	if (!resolved.sourceRoot) throw new Error(`当前工作区中的 ${packageId} 不包含源码目录，请改为优先读取本地随包文档。`);
@@ -1803,8 +1788,7 @@ async function runWeappViteCliTool(workspaceRoot, input) {
 	if (Array.isArray(input.args) && input.args.length > 0) finalArgs.push(...input.args);
 	return runCommand(workspaceRoot, "node", finalArgs, { timeoutMs: input.timeoutMs ?? 12e4 });
 }
-//#endregion
-//#region src/server/resources.ts
+// src/server/resources.ts
 function registerServerResources(server, options) {
 	const { workspaceRoot, packageIds, exposedPackages } = options;
 	server.registerResource("workspace-catalog", "weapp-vite://workspace/catalog", {
@@ -1880,16 +1864,14 @@ function registerServerResources(server, options) {
 		}
 	});
 }
-//#endregion
-//#region src/catalog.ts
+// src/catalog.ts
 async function loadPackageSummary(workspaceRoot, id) {
 	return resolveExposedPackage(workspaceRoot, id);
 }
 async function loadExposedCatalog(workspaceRoot) {
 	return resolveExposedPackages(workspaceRoot);
 }
-//#endregion
-//#region src/server/tools.ts
+// src/server/tools.ts
 function registerServerTools(server, options) {
 	const { workspaceRoot, packageIds, packageIdSchema } = options;
 	server.registerTool("workspace_catalog", {
@@ -2137,8 +2119,7 @@ function registerServerTools(server, options) {
 		}
 	});
 }
-//#endregion
-//#region src/server/index.ts
+// src/server/index.ts
 const packageIds = Object.keys(EXPOSED_PACKAGES);
 const packageIdSchema = z.enum(packageIds);
 async function createWeappViteMcpServerFactory(options) {
@@ -2210,8 +2191,7 @@ async function createWeappViteMcpServer(options) {
 		workspaceRoot: factory.workspaceRoot
 	};
 }
-//#endregion
-//#region src/server/runtime/rest.ts
+// src/server/runtime/rest.ts
 const connectionSchema = z.object({
 	cliPath: z.string().trim().min(1).optional(),
 	devtoolsChannel: z.enum([
@@ -2505,8 +2485,7 @@ async function handleRuntimeRestRequest(req, res, options) {
 	}
 	return true;
 }
-//#endregion
-//#region src/runtime.ts
+// src/runtime.ts
 function normalizeEndpoint(input) {
 	const value = typeof input === "string" ? input.trim() : "";
 	if (!value) return DEFAULT_MCP_ENDPOINT;
@@ -2637,8 +2616,7 @@ async function startWeappViteMcpServer(options) {
 	if ((options?.transport ?? "stdio") === "streamable-http") return startStreamableHttpServer(options ?? {});
 	return await startStdioServer(options);
 }
-//#endregion
-//#region src/index.ts
+// src/index.ts
 function isDirectExecution() {
 	const entry = process.argv[1];
 	if (!entry) return false;
@@ -2653,5 +2631,4 @@ if (isDirectExecution()) startStdioServer().catch((error) => {
 	process.stderr.write(`[mcp] server start failed\n${message}\n`);
 	process.exitCode = 1;
 });
-//#endregion
 export { DEFAULT_MAX_FILE_CHARS, DEFAULT_MAX_OUTPUT_CHARS, DEFAULT_MAX_RESULTS, DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_RUNTIME_REST_ENDPOINT, DEFAULT_TIMEOUT_MS, EXPOSED_PACKAGES, MCP_SERVER_NAME, MCP_SERVER_VERSION, SKIPPED_DIR_NAMES, acceptanceRuntime, assertInsideRoot, createRuntimeAcceptanceService, createWeappViteMcpServer, createWeappViteMcpServerFactory, formatJson, listFilesInDirectory, loadExposedCatalog, loadPackageSummary, normalizeErrorMessage, readFileContent, registerAcceptanceTools, resolveSubPath, resolveWorkspaceRoot, runCommand, searchTextInDirectory, startStdioServer, startWeappViteMcpServer, toToolError, toToolResult };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@weapp-vite/mcp",
   "type": "module",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "@weapp-vite/mcp tools and runtime components for modern WeChat and multi-platform mini-program development.",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "ISC",
@@ -37,19 +37,19 @@
     "dist"
   ],
   "engines": {
-    "node": ">=22.12.0"
+    "node": "^22.23.4 || ^24.22.1 || >=26.12.1"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@modelcontextprotocol/node": "^2.1.1",
-    "@modelcontextprotocol/server": "^2.3.1",
-    "@weapp-core/constants": "0.4.0",
-    "@weapp-vite/acceptance": "0.1.1",
-    "@weapp-vite/devtools-runtime": "0.6.0",
-    "weapp-ide-cli": "6.3.0",
+    "@modelcontextprotocol/node": "^2.1.2",
+    "@modelcontextprotocol/server": "^2.4.0",
+    "@weapp-core/constants": "0.5.0",
+    "@weapp-vite/acceptance": "0.2.0",
+    "@weapp-vite/devtools-runtime": "0.7.0",
+    "weapp-ide-cli": "6.4.0",
     "zod": "^4.6.7"
   },
   "tsd": {
@@ -59,7 +59,7 @@
     }
   },
   "devDependencies": {
-    "@modelcontextprotocol/client": "^2.3.1"
+    "@modelcontextprotocol/client": "^2.4.0"
   },
   "scripts": {
     "dev": "tsdown -w --sourcemap",