@cloudbase/cloudbase-mcp 2.23.8 → 2.23.9

package/dist/index.cjs

@@ -136836,7 +136836,7 @@ class TelemetryReporter {
         const nodeVersion = process.version; // Node.js版本
         const arch = os_1.default.arch(); // 系统架构
         // 从构建时注入的版本号获取MCP版本信息
-        const mcpVersion = process.env.npm_package_version || "2.23.8" || 0;
+        const mcpVersion = process.env.npm_package_version || "2.23.9" || 0;
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -160271,17 +160271,13 @@ exports["default"] = applicator;
 /***/ }),
 
 /***/ 56473:
-/***/ (function(__unused_webpack_module, exports, __webpack_require__) {
+/***/ ((__unused_webpack_module, exports, __webpack_require__) => {
 
 "use strict";
 
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", ({ value: true }));
+exports.__resetPgReadyCache = __resetPgReadyCache;
 exports.registerPGDatabaseTools = registerPGDatabaseTools;
-const node_fs_1 = __webpack_require__(89971);
-const node_path_1 = __importDefault(__webpack_require__(26743));
 const zod_1 = __webpack_require__(21614);
 const cloudbase_manager_js_1 = __webpack_require__(3431);
 const tool_result_js_1 = __webpack_require__(9835);
@@ -160296,7 +160292,6 @@ const QUERY_ACTIONS = [
     "sql",
 ];
 const MANAGE_ACTIONS = [
-    "init",
     "execute",
     "dryRun",
     "planMigration",
@@ -160317,63 +160312,19 @@ function buildNextAction(tool, action, reason, suggestedArgs) {
         reason,
     };
 }
-function getPgContextStorePath() {
-    return (process.env.CLOUDBASE_PG_CONTEXT_PATH ??
-        node_path_1.default.join(process.env.HOME ?? ".", ".cloudbase-mcp", "pg-context.json"));
-}
-async function loadStoredPgContext() {
-    if (!process.env.CLOUDBASE_PG_CONTEXT_PATH) {
-        return undefined;
-    }
-    try {
-        const raw = await node_fs_1.promises.readFile(getPgContextStorePath(), "utf8");
-        return JSON.parse(raw);
-    }
-    catch {
-        return undefined;
-    }
-}
-async function savePgContext(server, context) {
-    server.pgRuntimeContext = context;
-    if (!process.env.CLOUDBASE_PG_CONTEXT_PATH) {
-        return;
-    }
-    const storePath = getPgContextStorePath();
-    await node_fs_1.promises.mkdir(node_path_1.default.dirname(storePath), { recursive: true });
-    await node_fs_1.promises.writeFile(storePath, JSON.stringify(context, null, 2), {
-        encoding: "utf8",
-        mode: 0o600,
-    });
-    await node_fs_1.promises.chmod(storePath, 0o600).catch(() => undefined);
-}
-async function getPgContext(server) {
-    if (server.pgRuntimeContext) {
-        return server.pgRuntimeContext;
-    }
-    const stored = await loadStoredPgContext();
-    if (stored) {
-        server.pgRuntimeContext = stored;
-    }
-    return stored;
-}
-function buildMissingContextResult() {
-    return buildPgToolResult({
-        success: false,
-        errorCode: "PG_CONTEXT_NOT_INITIALIZED",
-        message: "PostgreSQL context is not initialized yet. Call managePgDatabase(action=init) to bind the current CloudBase environment's built-in PostgreSQL runtime.",
-        nextActions: [
-            buildNextAction(MANAGE_PG_DATABASE, "init", "初始化 CloudBase PG 云端执行上下文，然后再查询 schema 或执行 SQL。", { action: "init" }),
-        ],
-    });
-}
-function sanitizePgContext(context) {
+/**
+ * 从 cloudBaseOptions + args 推导 PG 执行上下文（无状态）
+ * 照搬 MySQL 的 resolveSqlDbContext 模式
+ */
+async function resolvePgDbContext(cloudBaseOptions, args) {
+    const envId = args?.envId ??
+        cloudBaseOptions?.envId ??
+        (await (0, cloudbase_manager_js_1.getEnvId)(cloudBaseOptions));
     return {
-        envId: context.envId,
-        instanceId: context.instanceId,
-        defaultSchema: context.defaultSchema,
-        runtimeMode: context.runtimeMode,
-        bootstrapMode: context.bootstrapMode,
-        role: context.role,
+        envId,
+        instanceId: args?.instanceId ?? "cloudbase-pg",
+        defaultSchema: args?.defaultSchema ?? "public",
+        role: args?.role ?? "cloudbase_admin",
     };
 }
 function normalizeLimit(limit, fallback = 20, max = 200) {
@@ -160941,89 +160892,65 @@ function createManagerPgClient(context, cloudBaseOptions) {
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-async function ensurePgReady(context, deps, options) {
-    const maxAttempts = options?.maxAttempts ?? 20;
-    const retryDelayMs = options?.retryDelayMs ?? 1000;
-    let lastError;
-    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
-        try {
-            await withPgClient(context, deps, async (client) => {
-                await client.query("SELECT 1");
-            });
-            return;
-        }
-        catch (error) {
-            lastError = error;
-            if (attempt === maxAttempts) {
-                break;
-            }
-            await sleep(retryDelayMs);
-        }
-    }
-    const reason = lastError instanceof Error ? lastError.message : String(lastError);
-    throw new Error(`PostgreSQL is not ready after ${maxAttempts} attempts. Last error: ${reason}`);
+/**
+ * 模块级 Promise 缓存：同一 server 生命周期内只探测一次 PG 就绪状态
+ * 照搬 MySQL lazy 就绪检查模式，避免每次业务调用都 SELECT 1
+ */
+let pgReadyPromise = null;
+/**
+ * @internal 重置就绪探测缓存（仅供测试使用）
+ */
+function __resetPgReadyCache() {
+    pgReadyPromise = null;
 }
-async function handleInit(args, server, deps) {
-    const existing = await getPgContext(server);
-    const resolvedEnvId = args.envId ??
-        server.cloudBaseOptions?.envId ??
-        process.env.CLOUDBASE_ENV_ID ??
-        existing?.envId;
-    if (!resolvedEnvId) {
-        return buildPgToolResult({
-            success: false,
-            errorCode: "ENV_ID_REQUIRED",
-            message: "CloudBase PostgreSQL only supports the built-in cloud runtime. Provide envId or bind a CloudBase environment before calling managePgDatabase(action=init).",
-        });
+/**
+ * 首次 SQL 调用时探测 PG 就绪，Promise 缓存避免重复探测
+ * 探测失败抛错，由调用方捕获返回 PG_NOT_READY 错误码
+ */
+async function ensurePgReadyOnce(cloudBaseOptions, deps) {
+    if (pgReadyPromise) {
+        return pgReadyPromise;
     }
-    const bootstrapResult = {
-        instanceId: args.instanceId ?? "cloudbase-pg",
-        defaultSchema: args.defaultSchema ?? "public",
-        status: "ready",
-        runtimeMode: "cloudbase-manager",
-        role: args.role ?? "cloudbase_admin",
-    };
-    const now = new Date().toISOString();
-    const context = {
-        envId: resolvedEnvId,
-        instanceId: bootstrapResult.instanceId,
-        defaultSchema: bootstrapResult.defaultSchema,
-        runtimeMode: "cloudbase-manager",
-        bootstrapMode: "cloud",
-        role: bootstrapResult.role,
-        createdAt: existing?.createdAt ?? now,
-        updatedAt: now,
-    };
-    await ensurePgReady(context, deps, deps.readyCheckOptions);
-    await savePgContext(server, context);
-    return buildPgToolResult({
-        success: true,
-        data: {
-            context: {
-                ...sanitizePgContext(context),
-            },
-            status: bootstrapResult.status,
-        },
-        message: "CloudBase PG 云端执行上下文已就绪。先查询对象或 schema，再执行写入 SQL。",
-        nextActions: [
-            buildNextAction(QUERY_PG_DATABASE, "objects", "List schema-qualified database objects before drilling into a specific table.", { action: "objects", limit: 20 }),
-            buildSchemaNextAction("Inspect a concrete schema-qualified table after you know which object matters.", `${context.defaultSchema}.your_table`),
-        ],
-    });
+    pgReadyPromise = (async () => {
+        const context = await resolvePgDbContext(cloudBaseOptions);
+        const maxAttempts = deps.readyCheckOptions?.maxAttempts ?? 20;
+        const retryDelayMs = deps.readyCheckOptions?.retryDelayMs ?? 1000;
+        let lastError;
+        for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+            try {
+                await withPgClient(context, deps, async (client) => {
+                    await client.query("SELECT 1");
+                });
+                return;
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt === maxAttempts) {
+                    break;
+                }
+                await sleep(retryDelayMs);
+            }
+        }
+        const reason = lastError instanceof Error ? lastError.message : String(lastError);
+        throw new Error(`PostgreSQL is not ready after ${maxAttempts} attempts. Last error: ${reason}`);
+    })();
+    return pgReadyPromise;
 }
 async function handleQueryContext(server) {
-    const context = await getPgContext(server);
-    if (!context) {
-        return buildMissingContextResult();
-    }
+    const context = await resolvePgDbContext(server.cloudBaseOptions);
     return buildPgToolResult({
         success: true,
         data: {
             context: {
-                ...sanitizePgContext(context),
+                envId: context.envId,
+                instanceId: context.instanceId,
+                defaultSchema: context.defaultSchema,
+                runtimeMode: "cloudbase-manager",
+                bootstrapMode: "cloud",
+                role: context.role,
             },
         },
-        message: "Resolved current CloudBase PostgreSQL context.",
+        message: "Resolved current CloudBase PostgreSQL context (auto-derived).",
         nextActions: [
             buildNextAction(QUERY_PG_DATABASE, "objects", "List schema-qualified objects before inspecting an individual table.", { action: "objects", limit: 20 }),
         ],
@@ -161419,9 +161346,20 @@ function registerPGDatabaseTools(server, providedDeps) {
         if (args.action === "context") {
             return handleQueryContext(server);
         }
-        const context = await getPgContext(server);
-        if (!context) {
-            return buildMissingContextResult();
+        const context = await resolvePgDbContext(server.cloudBaseOptions);
+        try {
+            await ensurePgReadyOnce(server.cloudBaseOptions, deps);
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            return buildPgToolResult({
+                success: false,
+                errorCode: "PG_NOT_READY",
+                message: `CloudBase PostgreSQL is not ready. ${reason}`,
+                nextActions: [
+                    buildNextAction("queryEnv", "info", "检查当前环境 PostgreSQL 实例状态。", { action: "info", envId: context.envId }),
+                ],
+            });
         }
         switch (args.action) {
             case "objects":
@@ -161442,11 +161380,11 @@ function registerPGDatabaseTools(server, providedDeps) {
     });
     server.registerTool?.(MANAGE_PG_DATABASE, {
         title: "管理 PostgreSQL 上下文或执行写入 SQL",
-        description: "管理 CloudBase PostgreSQL MCP 上下文。仅支持 CloudBase 内置 PostgreSQL 云端 Manager SDK 执行路径、SQL 风险预检、迁移规划，以及在显式确认后执行写入 SQL。",
+        description: "管理 CloudBase PostgreSQL：执行已确认的写入 SQL 或 DDL、SQL 风险预检、迁移规划。上下文自动从当前 MCP 环境推导，无需 init。仅支持 CloudBase 内置 PostgreSQL 云端 Manager SDK 执行路径。",
         inputSchema: {
             action: zod_1.z
                 .enum(MANAGE_ACTIONS)
-                .describe("操作类型：init=初始化或绑定 PostgreSQL 上下文；execute=执行已确认的写入 SQL 或 DDL；dryRun=只分析 SQL 风险不执行；planMigration=通过 PreviewPGUserMigrations 预览迁移计划；applyMigration=通过 PushPGUserMigrations 应用迁移；listMigrations=查询已应用的 Migration 列表；migrationDetail=查看单条 Migration 详情；rollbackMigration=回滚指定 Migration"),
+                .describe("操作类型：execute=执行已确认的写入 SQL 或 DDL；dryRun=只分析 SQL 风险不执行；planMigration=通过 PreviewPGUserMigrations 预览迁移计划；applyMigration=通过 PushPGUserMigrations 应用迁移；listMigrations=查询已应用的 Migration 列表；migrationDetail=查看单条 Migration 详情；rollbackMigration=回滚指定 Migration"),
             sql: zod_1.z
                 .string()
                 .optional()
@@ -161462,11 +161400,11 @@ function registerPGDatabaseTools(server, providedDeps) {
             instanceId: zod_1.z
                 .string()
                 .optional()
-                .describe("可选的 PostgreSQL 逻辑实例标识。"),
+                .describe("可选的 PostgreSQL 逻辑实例标识，默认 cloudbase-pg。"),
             defaultSchema: zod_1.z
                 .string()
                 .optional()
-                .describe("默认 schema，会保存到 PG 上下文中，默认 public。"),
+                .describe("可选的默认 schema，默认 public。"),
             role: zod_1.z
                 .string()
                 .optional()
@@ -161484,13 +161422,23 @@ function registerPGDatabaseTools(server, providedDeps) {
             category: CATEGORY,
         },
     }, async (args) => {
+        const context = await resolvePgDbContext(server.cloudBaseOptions, args);
+        const cbOpts = server.cloudBaseOptions;
         switch (args.action) {
-            case "init":
-                return handleInit(args, server, deps);
             case "execute": {
-                const context = await getPgContext(server);
-                if (!context) {
-                    return buildMissingContextResult();
+                try {
+                    await ensurePgReadyOnce(cbOpts, deps);
+                }
+                catch (error) {
+                    const reason = error instanceof Error ? error.message : String(error);
+                    return buildPgToolResult({
+                        success: false,
+                        errorCode: "PG_NOT_READY",
+                        message: `CloudBase PostgreSQL is not ready. ${reason}`,
+                        nextActions: [
+                            buildNextAction("queryEnv", "info", "检查当前环境 PostgreSQL 实例状态。", { action: "info", envId: context.envId }),
+                        ],
+                    });
                 }
                 return handleExecuteSql(args, context, deps);
             }
@@ -161501,17 +161449,12 @@ function registerPGDatabaseTools(server, providedDeps) {
             case "listMigrations":
             case "migrationDetail":
             case "rollbackMigration": {
-                const migrationCtx = await getPgContext(server);
-                if (!migrationCtx) {
-                    return buildMissingContextResult();
-                }
-                const cbOpts = server.cloudBaseOptions;
                 switch (args.action) {
-                    case "planMigration": return handlePlanMigration(args, migrationCtx, deps, cbOpts);
-                    case "applyMigration": return handleApplyMigration(args, migrationCtx, deps, cbOpts);
-                    case "listMigrations": return handleListMigrations(args, migrationCtx, deps, cbOpts);
-                    case "migrationDetail": return handleMigrationDetail(args, migrationCtx, deps, cbOpts);
-                    case "rollbackMigration": return handleRollbackMigration(args, migrationCtx, deps, cbOpts);
+                    case "planMigration": return handlePlanMigration(args, context, deps, cbOpts);
+                    case "applyMigration": return handleApplyMigration(args, context, deps, cbOpts);
+                    case "listMigrations": return handleListMigrations(args, context, deps, cbOpts);
+                    case "migrationDetail": return handleMigrationDetail(args, context, deps, cbOpts);
+                    case "rollbackMigration": return handleRollbackMigration(args, context, deps, cbOpts);
                     default: return buildPgToolResult({ success: false, errorCode: "UNSUPPORTED_ACTION", message: `Unsupported action: ${args.action}` });
                 }
             }
@@ -196621,7 +196564,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || "2.23.8" || 0}
+- MCP 版本：${process.env.npm_package_version || "2.23.9" || 0}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -196702,7 +196645,7 @@ function createWrappedHandler(name, handler, server) {
                 requestId: (typeof error === 'object' && error && 'requestId' in error) ? error.requestId : '',
                 ide: server.ide || process.env.INTEGRATION_IDE || ''
             });
-            const mcpVersion =  true ? "2.23.8" : 0;
+            const mcpVersion =  true ? "2.23.9" : 0;
             const requestIdSuffix = requestId ? `\n🆔 RequestId: ${requestId}` : '';
             const enhancedErrorMessage = `${errorMessage}${requestIdSuffix}\n\n📦 CloudBase MCP v${mcpVersion}\n🔗 遇到问题？请复制以下链接到浏览器打开\n即可自动携带错误详情快速创建 GitHub Issue：\n${issueLink}`;
             // 创建新的错误对象，保持原有的错误类型但更新消息
@@ -212716,7 +212659,7 @@ function registerSetupTools(server) {
     server.registerTool("downloadTemplate", {
         title: "下载项目模板",
         description: `自动下载并部署CloudBase项目模板。
-**Note**: Call this tool when the user requests to create a new project using a CloudBase template.\n\n支持的模板:\n- react: React + CloudBase 全栈应用模板\n- vue: Vue + CloudBase 全栈应用模板\n- miniprogram: 微信小程序 + 云开发模板  \n- uniapp: UniApp + CloudBase 跨端应用模板\n- rules: 只包含AI编辑器配置文件（包含Cursor、WindSurf、CodeBuddy等所有主流编辑器配置），适合在已有项目中补充AI编辑器配置\n\n支持的IDE类型:\n- all: 下载所有IDE配置\n- cursor: Cursor AI编辑器\n- 其他IDE类型见下方列表\n\n注意：如果未传入 ide 参数且无法从环境变量检测到 IDE，将提示错误并要求传入 ide 参数\n- windsurf: WindSurf AI编辑器\n- codebuddy: CodeBuddy AI编辑器\n- claude-code: Claude Code AI编辑器\n- cline: Cline AI编辑器\n- gemini-cli: Gemini CLI\n- opencode: OpenCode AI编辑器\n- qwen-code: 通义灵码\n- baidu-comate: 百度Comate\n- openai-codex-cli: OpenAI Codex CLI\n- augment-code: Augment Code\n- github-copilot: GitHub Copilot\n- roocode: RooCode AI编辑器\n- tongyi-lingma: 通义灵码\n- trae: Trae AI编辑器\n- qoder: Qoder AI编辑器\n- antigravity: Google Antigravity AI编辑器\n- vscode: Visual Studio Code\n- kiro: Kiro AI编辑器\n- aider: Aider AI编辑器\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.23.8" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
+**Note**: Call this tool when the user requests to create a new project using a CloudBase template.\n\n支持的模板:\n- react: React + CloudBase 全栈应用模板\n- vue: Vue + CloudBase 全栈应用模板\n- miniprogram: 微信小程序 + 云开发模板  \n- uniapp: UniApp + CloudBase 跨端应用模板\n- rules: 只包含AI编辑器配置文件（包含Cursor、WindSurf、CodeBuddy等所有主流编辑器配置），适合在已有项目中补充AI编辑器配置\n\n支持的IDE类型:\n- all: 下载所有IDE配置\n- cursor: Cursor AI编辑器\n- 其他IDE类型见下方列表\n\n注意：如果未传入 ide 参数且无法从环境变量检测到 IDE，将提示错误并要求传入 ide 参数\n- windsurf: WindSurf AI编辑器\n- codebuddy: CodeBuddy AI编辑器\n- claude-code: Claude Code AI编辑器\n- cline: Cline AI编辑器\n- gemini-cli: Gemini CLI\n- opencode: OpenCode AI编辑器\n- qwen-code: 通义灵码\n- baidu-comate: 百度Comate\n- openai-codex-cli: OpenAI Codex CLI\n- augment-code: Augment Code\n- github-copilot: GitHub Copilot\n- roocode: RooCode AI编辑器\n- tongyi-lingma: 通义灵码\n- trae: Trae AI编辑器\n- qoder: Qoder AI编辑器\n- antigravity: Google Antigravity AI编辑器\n- vscode: Visual Studio Code\n- kiro: Kiro AI编辑器\n- aider: Aider AI编辑器\n\n特别说明：\n- rules 模板会自动包含当前 mcp 版本号信息（版本号：${ true ? "2.23.9" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])

package/dist/index.d.ts

@@ -159,7 +159,6 @@ export declare interface ExtendedMcpServer extends McpServer {
     authOptions?: AuthOptions;
     ide?: string;
     logger?: Logger;
-    pgRuntimeContext?: PgRuntimeContext;
     enabledPlugins?: string[];
     pluginOptions?: PluginOptions;
     /** 已注册工具的列表，供外部（如微信 IDE）提取并注册到自己的 MCP server */
@@ -333,17 +332,6 @@ export declare function logout(): Promise<void>;
 
 export { McpServer }
 
-declare interface PgRuntimeContext {
-    envId: string;
-    instanceId: string;
-    defaultSchema: string;
-    runtimeMode: "cloudbase-manager";
-    bootstrapMode: "cloud";
-    role?: string;
-    createdAt: string;
-    updatedAt: string;
-}
-
 /** 各插件的可选配置 */
 export declare interface PluginOptions {
     functions?: FunctionDeployOverrides;