@cloudbase/cloudbase-mcp 2.33.0 → 2.33.1

package/dist/index.cjs

@@ -199258,6 +199258,7 @@ exports.getAuthProgressState = getAuthProgressState;
 exports.resolveAuthOptions = resolveAuthOptions;
 exports.getAuthConfigValidationError = getAuthConfigValidationError;
 exports.buildAuthConfigSummary = buildAuthConfigSummary;
+exports.buildDeviceLoginOptions = buildDeviceLoginOptions;
 exports.setPendingAuthProgressState = setPendingAuthProgressState;
 exports.resolveAuthProgressState = resolveAuthProgressState;
 exports.rejectAuthProgressState = rejectAuthProgressState;
@@ -199476,9 +199477,10 @@ function getAuthConfigValidationError(options) {
     if (options.oauthCustom && !options.oauthEndpoint) {
         return "oauthCustom=true 时必须同时提供 oauthEndpoint。";
     }
-    if (options.oauthEndpoint && !options.oauthCustom) {
-        return "配置自定义 oauthEndpoint 时必须启用 oauthCustom=true。";
-    }
+    // oauthEndpoint + 显式 oauthCustom=false 放行：resolveAuthOptions 对"只配 endpoint
+    // 未配 custom"已默认 custom=true，走到这里的 endpoint+false 只可能是用户显式指定——
+    // 即标准 {code,result} 包装格式的自定义端点（如国际站 tcb-api.tencentcloud.com），
+    // 拦截会导致标准格式端点在工具层永远不可用。
     return null;
 }
 function buildAuthConfigSummary(options) {
@@ -199490,6 +199492,40 @@ function buildAuthConfigSummary(options) {
         uses_toolbox_defaults: options.usesToolboxDefaults,
     };
 }
+/**
+ * 构造 device flow 的 loginByWebAuth 基础参数（onDeviceCode 由调用方按需注入）。
+ *
+ * 所有 device 登录路径（ensureLogin 与 auth 工具 start_auth 的 device 分支）必须
+ * 共享本函数：TCB_SITE=intl 时的 getOAuthEndpoint 覆写与 getAuthUrl 授权页改写
+ * 只在 ensureLogin 生效，会导致工具层直连路径仍打国内站端点/授权页，国际站账号
+ * 无法完成授权（device-code 注册表国内外隔离，国内授权页对国际站账号无效）。
+ */
+function buildDeviceLoginOptions(resolvedAuthOptions, siteHints = {}) {
+    const resolvedSite = (0, site_map_js_1.resolveSite)(siteHints.region, siteHints.site ?? process.env.TCB_SITE);
+    const loginOptions = { flow: "device" };
+    if (resolvedAuthOptions.clientId) {
+        loginOptions.client_id = resolvedAuthOptions.clientId;
+    }
+    if (resolvedAuthOptions.oauthEndpoint) {
+        loginOptions.getOAuthEndpoint = () => resolvedAuthOptions.oauthEndpoint;
+    }
+    else if (resolvedSite === "intl") {
+        // 国际站 OAuth 后端独立部署（2026-09-01 实测 device/code+token 可用，注册表与国内站隔离）；
+        // 不覆写时 toolbox 默认打国内站端点，国际站账号无法完成授权
+        loginOptions.getOAuthEndpoint = () => site_map_js_1.SITE_REGION_MAP.intl.oauthEndpoint;
+    }
+    if (resolvedSite === "intl") {
+        // device 模式的 verification_uri 标准模式下由客户端拼接，指向国内站授权页；
+        // 与 web 模式同款 host 改写，把授权页切到国际站
+        loginOptions.getAuthUrl = (url) => url
+            .replace(`${site_map_js_1.SITE_REGION_MAP.domestic.authHost}/dev`, `${site_map_js_1.SITE_REGION_MAP.intl.authHost}/dev`)
+            .replace(site_map_js_1.SITE_REGION_MAP.domestic.authHost, site_map_js_1.SITE_REGION_MAP.intl.authHost);
+    }
+    if (resolvedAuthOptions.oauthCustom) {
+        loginOptions.custom = true;
+    }
+    return loginOptions;
+}
 function setPendingAuthProgressState(challenge, authMode = "device") {
     return updateAuthProgressState({
         status: "PENDING",
@@ -199729,27 +199765,11 @@ async function ensureLogin(options) {
                     };
         }
         else {
-            if (resolvedAuthOptions.clientId) {
-                loginOptions.client_id = resolvedAuthOptions.clientId;
-            }
-            if (resolvedAuthOptions.oauthEndpoint) {
-                loginOptions.getOAuthEndpoint = () => resolvedAuthOptions.oauthEndpoint;
-            }
-            else if (resolvedSite === "intl") {
-                // 国际站 OAuth 后端独立部署（2026-09-01 实测 device/code+token 可用，注册表与国内站隔离）；
-                // 不覆写时 toolbox 默认打国内站端点，国际站账号无法完成授权
-                loginOptions.getOAuthEndpoint = () => site_map_js_1.SITE_REGION_MAP.intl.oauthEndpoint;
-            }
-            if (resolvedSite === "intl") {
-                // device 模式的 verification_uri 标准模式下由客户端拼接，指向国内站授权页；
-                // 与 web 模式同款 host 改写，把授权页切到国际站
-                loginOptions.getAuthUrl = (url) => url
-                    .replace(`${site_map_js_1.SITE_REGION_MAP.domestic.authHost}/dev`, `${site_map_js_1.SITE_REGION_MAP.intl.authHost}/dev`)
-                    .replace(site_map_js_1.SITE_REGION_MAP.domestic.authHost, site_map_js_1.SITE_REGION_MAP.intl.authHost);
-            }
-            if (resolvedAuthOptions.oauthCustom) {
-                loginOptions.custom = true;
-            }
+            // device 模式：与 auth 工具 start_auth device 分支共享 intl 端点覆写与授权页改写
+            Object.assign(loginOptions, buildDeviceLoginOptions(resolvedAuthOptions, {
+                region: options?.region,
+                site: options?.site,
+            }));
             if (options?.onDeviceCode) {
                 loginOptions.onDeviceCode = (info) => {
                     setPendingAuthProgressState(info, mode);
@@ -201353,7 +201373,7 @@ async function getInteractiveServerAsync() {
 "use strict";
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.telemetryReporter = exports.reportToolkitLifecycle = exports.reportToolCall = exports.warn = exports.info = exports.error = exports.StdioServerTransport = void 0;
+exports.normalizeClientName = exports.telemetryReporter = exports.reportToolkitLifecycle = exports.reportToolCall = exports.warn = exports.info = exports.error = exports.StdioServerTransport = void 0;
 exports.createCloudBaseMcpServer = createCloudBaseMcpServer;
 exports.getDefaultServer = getDefaultServer;
 const mcp_js_1 = __webpack_require__(55375);
@@ -201384,6 +201404,7 @@ const logger_js_1 = __webpack_require__(40781);
 const site_map_js_1 = __webpack_require__(34533);
 const tool_result_js_1 = __webpack_require__(69645);
 const tool_wrapper_js_1 = __webpack_require__(93389);
+const telemetry_js_1 = __webpack_require__(5198);
 // 默认插件列表
 const DEFAULT_PLUGINS = [
     "env",
@@ -201527,7 +201548,7 @@ function parseEnabledPlugins(pluginsEnabled, pluginsDisabled) {
  * await server.connect(transport);
  */
 async function createCloudBaseMcpServer(options) {
-    const { name = "cloudbase-mcp", version = "1.0.0", enableTelemetry = true, cloudBaseOptions, authOptions, cloudMode = false, ide, logger, pluginsEnabled, pluginsDisabled, pluginOptions, } = options ?? {};
+    const { name = "cloudbase-mcp", version = "1.0.0", enableTelemetry = true, cloudBaseOptions, authOptions, cloudMode = false, ide, client, logger, pluginsEnabled, pluginsDisabled, pluginOptions, } = options ?? {};
     // Enable cloud mode if specified
     if (cloudMode) {
         (0, cloud_mode_js_1.enableCloudMode)();
@@ -201590,6 +201611,11 @@ async function createCloudBaseMcpServer(options) {
     if (ide) {
         server.ide = ide;
     }
+    // Store client in server instance for telemetry (normalized, invalid values dropped)
+    const normalizedClient = (0, telemetry_js_1.normalizeClientName)(client);
+    if (normalizedClient) {
+        server.client = normalizedClient;
+    }
     // Store logger in server instance for tools to access
     if (logger) {
         server.logger = logger;
@@ -201624,10 +201650,11 @@ var logger_js_2 = __webpack_require__(40781);
 Object.defineProperty(exports, "error", ({ enumerable: true, get: function () { return logger_js_2.error; } }));
 Object.defineProperty(exports, "info", ({ enumerable: true, get: function () { return logger_js_2.info; } }));
 Object.defineProperty(exports, "warn", ({ enumerable: true, get: function () { return logger_js_2.warn; } }));
-var telemetry_js_1 = __webpack_require__(5198);
-Object.defineProperty(exports, "reportToolCall", ({ enumerable: true, get: function () { return telemetry_js_1.reportToolCall; } }));
-Object.defineProperty(exports, "reportToolkitLifecycle", ({ enumerable: true, get: function () { return telemetry_js_1.reportToolkitLifecycle; } }));
-Object.defineProperty(exports, "telemetryReporter", ({ enumerable: true, get: function () { return telemetry_js_1.telemetryReporter; } }));
+var telemetry_js_2 = __webpack_require__(5198);
+Object.defineProperty(exports, "reportToolCall", ({ enumerable: true, get: function () { return telemetry_js_2.reportToolCall; } }));
+Object.defineProperty(exports, "reportToolkitLifecycle", ({ enumerable: true, get: function () { return telemetry_js_2.reportToolkitLifecycle; } }));
+Object.defineProperty(exports, "telemetryReporter", ({ enumerable: true, get: function () { return telemetry_js_2.telemetryReporter; } }));
+Object.defineProperty(exports, "normalizeClientName", ({ enumerable: true, get: function () { return telemetry_js_2.normalizeClientName; } }));
 
 
 /***/ },
@@ -213937,7 +213964,7 @@ function registerEnvTools(server) {
                         oauthCustom: zod_1.z
                             .boolean()
                             .optional()
-                            .describe("高级可选：自定义 endpoint 返回格式开关。未配置 endpoint 时默认 false；配置 endpoint 后默认 true，且不能设为 false"),
+                            .describe("高级可选：自定义 endpoint 返回格式开关。未配置 endpoint 时默认 false；配置 endpoint 后默认 true。标准 {code,result} 包装格式的端点（如国际站 tcb-api.tencentcloud.com）应显式传 false"),
                     }
                     : {}),
                 envId: zod_1.z
@@ -214182,19 +214209,15 @@ function registerEnvTools(server) {
                             }
                         };
                         try {
-                            // 启动 Device Flow，全流程由 toolbox 负责轮询和写入 credential，这里不等待完成
+                            // 启动 Device Flow，全流程由 toolbox 负责轮询和写入 credential，这里不等待完成。
+                            // 登录参数（含 TCB_SITE=intl 端点覆写与授权页改写）与 ensureLogin 共享同一 helper，
+                            // 避免此直连路径绕过国际站改写导致国际站账号拿到的仍是国内站链接
                             auth
                                 .loginByWebAuth({
-                                flow: "device",
-                                ...(resolvedAuthOptions.clientId
-                                    ? { client_id: resolvedAuthOptions.clientId }
-                                    : {}),
-                                ...(resolvedAuthOptions.oauthEndpoint
-                                    ? { getOAuthEndpoint: () => resolvedAuthOptions.oauthEndpoint }
-                                    : {}),
-                                ...(resolvedAuthOptions.oauthCustom
-                                    ? { custom: true }
-                                    : {}),
+                                ...(0, auth_js_1.buildDeviceLoginOptions)(resolvedAuthOptions, {
+                                    region,
+                                    site: server.cloudBaseOptions?.site,
+                                }),
                                 onDeviceCode: deviceOnCode,
                             })
                                 .then(async () => {
@@ -224094,7 +224117,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.33.0" : 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.33.1" : 0}），便于后续维护和版本追踪\n- 下载 rules 模板时，如果项目中已存在 README.md 文件，系统会自动保护该文件不被覆盖（除非设置 overwrite=true）`,
         inputSchema: {
             template: zod_1.z
                 .enum(["react", "vue", "miniprogram", "uniapp", "rules"])
@@ -226323,12 +226346,14 @@ Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.reportToolkitLifecycle = exports.reportToolCall = exports.telemetryReporter = void 0;
 exports.extractMcpClientInfo = extractMcpClientInfo;
 exports.readMcpClientInfoFromServer = readMcpClientInfoFromServer;
+exports.normalizeClientName = normalizeClientName;
 const crypto_1 = __importDefault(__webpack_require__(55511));
 const http_1 = __importDefault(__webpack_require__(81630));
 const https_1 = __importDefault(__webpack_require__(55591));
 const os_1 = __importDefault(__webpack_require__(21820));
 const cloudbase_manager_js_1 = __webpack_require__(33109);
 const logger_js_1 = __webpack_require__(40781);
+const site_map_js_1 = __webpack_require__(34533);
 /**
  * 数据上报类
  * 用于收集 MCP 工具使用情况和错误信息，帮助改进产品
@@ -226358,6 +226383,12 @@ class TelemetryReporter {
             this.addAdditionalParams({ ide: process.env.INTEGRATION_IDE });
             (0, logger_js_1.debug)('检测到 IDE 集成环境', { ide: process.env.INTEGRATION_IDE });
         }
+        // 检查 CLOUDBASE_MCP_CLIENT 环境变量（hosted 场景由上游解析真实 MCP client 后注入）
+        const envClient = normalizeClientName(process.env.CLOUDBASE_MCP_CLIENT);
+        if (envClient) {
+            this.addAdditionalParams({ client: envClient });
+            (0, logger_js_1.debug)('检测到 MCP client 标识', { client: envClient });
+        }
         (0, logger_js_1.debug)('report_init', {
             enabled: this.enabled,
             deviceId: this.deviceId.substring(0, 8) + '...',
@@ -226375,7 +226406,7 @@ class TelemetryReporter {
         const arch = os_1.default.arch(); // 系统架构
         // Build-time injected version; guard for vitest / non-webpack runtimes.
         const mcpVersion = process.env.npm_package_version ||
-            ( true ? "2.33.0" : 0);
+            ( true ? "2.33.1" : 0);
         return {
             userAgent: `${osType} ${osRelease} ${arch} ${nodeVersion} CloudBase-MCP/${mcpVersion}`,
             deviceId: this.deviceId,
@@ -226586,6 +226617,58 @@ function readMcpClientInfoFromServer(server) {
         return {};
     }
 }
+/**
+ * Normalize upstream-provided client identifier into a telemetry-safe token:
+ * trim + lowercase + keep [a-z0-9-_] only + cap at 64 chars.
+ * Canonical mapping (cursor-vscode -> cursor etc.) is the upstream's responsibility;
+ * we only sanitize. Returns undefined when nothing usable remains.
+ */
+function normalizeClientName(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const cleaned = value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]/g, "")
+        .slice(0, 64);
+    return cleaned || undefined;
+}
+// 进程内缓存 site/region 解析结果（resolveSiteAndRegion 会读项目配置文件，避免每次工具调用都走 IO）
+let cachedSiteRegion = null;
+/**
+ * Resolve region/site for telemetry.
+ * Priority: cloudBaseOptions（会话实际使用值）> resolveSiteAndRegion（env/项目配置解析，进程内缓存）。
+ * 失败时降级 unknown，绝不影响工具调用主链路。
+ */
+function resolveTelemetrySiteRegion(cloudBaseOptions) {
+    const explicitRegion = cloudBaseOptions?.region;
+    const explicitSite = (0, site_map_js_1.normalizeSite)(cloudBaseOptions?.site);
+    try {
+        if (!cachedSiteRegion) {
+            const resolved = (0, site_map_js_1.resolveSiteAndRegion)();
+            cachedSiteRegion = { site: resolved.site, region: resolved.region };
+        }
+        return {
+            region: explicitRegion || cachedSiteRegion.region,
+            site: explicitSite || cachedSiteRegion.site,
+        };
+    }
+    catch (err) {
+        (0, logger_js_1.debug)('解析 site/region 失败，遥测使用 unknown', err instanceof Error ? err : new Error(String(err)));
+        return {
+            region: explicitRegion || 'unknown',
+            site: explicitSite || 'unknown',
+        };
+    }
+}
+/**
+ * Resolve MCP client identifier for a single report:
+ * explicit param (server.client) > CLOUDBASE_MCP_CLIENT env (hosted upstream injection).
+ */
+function resolveClientName(explicit) {
+    return normalizeClientName(explicit || process.env.CLOUDBASE_MCP_CLIENT);
+}
 function appendMcpClientInfoFields(eventData, clientInfo) {
     if (!clientInfo) {
         return;
@@ -226605,6 +226688,7 @@ const reportToolCall = async (params) => {
     const { nodeVersion, osType, osRelease, arch, mcpVersion } = exports.telemetryReporter.getUserAgent();
     // 安全获取环境ID，优先使用传入的配置
     const { envId, envIdSource } = resolveEnvId(params.cloudBaseOptions);
+    const siteRegion = resolveTelemetrySiteRegion(params.cloudBaseOptions);
     (0, logger_js_1.debug)('[telemetry] 工具调用 envId 获取结果', {
         toolName: params.toolName,
         envId,
@@ -226620,6 +226704,8 @@ const reportToolCall = async (params) => {
         duration: params.duration !== undefined ? String(params.duration) : undefined,
         error: params.error ? params.error.substring(0, 200) : undefined, // 限制错误信息长度
         envId: envId || 'unknown',
+        region: siteRegion.region,
+        site: siteRegion.site,
         nodeVersion,
         osType,
         osRelease,
@@ -226644,6 +226730,11 @@ const reportToolCall = async (params) => {
     if (params.ide) {
         eventData.ide = params.ide;
     }
+    // 添加 MCP client 标识（如果提供）
+    const client = resolveClientName(params.client);
+    if (client) {
+        eventData.client = client;
+    }
     appendMcpClientInfoFields(eventData, params.mcpClientInfo);
     // Debug: 打印最终上报参数
     (0, logger_js_1.debug)('[telemetry] 工具调用上报参数', {
@@ -226663,6 +226754,7 @@ const reportToolkitLifecycle = async (params) => {
     const { nodeVersion, osType, osRelease, arch, mcpVersion } = exports.telemetryReporter.getUserAgent();
     // 安全获取环境ID，优先使用传入的配置
     const { envId, envIdSource } = resolveEnvId(params.cloudBaseOptions);
+    const siteRegion = resolveTelemetrySiteRegion(params.cloudBaseOptions);
     (0, logger_js_1.debug)('[telemetry] 生命周期事件 envId 获取结果', {
         event: params.event,
         envId,
@@ -226677,6 +226769,8 @@ const reportToolkitLifecycle = async (params) => {
         exitCode: params.exitCode !== undefined ? String(params.exitCode) : undefined,
         error: params.error ? params.error.substring(0, 200) : undefined, // 限制错误信息长度
         envId: envId || 'unknown',
+        region: siteRegion.region,
+        site: siteRegion.site,
         nodeVersion,
         osType,
         osRelease,
@@ -226687,6 +226781,11 @@ const reportToolkitLifecycle = async (params) => {
     if (params.ide) {
         eventData.ide = params.ide;
     }
+    // 添加 MCP client 标识（如果提供）
+    const lifecycleClient = resolveClientName(params.client);
+    if (lifecycleClient) {
+        eventData.client = lifecycleClient;
+    }
     appendMcpClientInfoFields(eventData, params.mcpClientInfo);
     // Debug: 打印最终上报参数
     (0, logger_js_1.debug)('[telemetry] 生命周期事件上报参数', {
@@ -226900,7 +226999,7 @@ ${envIdSection}
 ## 环境信息
 - 操作系统: ${os_1.default.type()} ${os_1.default.release()}
 - Node.js版本: ${process.version}
-- MCP 版本：${process.env.npm_package_version || ( true ? "2.33.0" : 0)}
+- MCP 版本：${process.env.npm_package_version || ( true ? "2.33.1" : 0)}
 - 系统架构: ${os_1.default.arch()}
 - 时间: ${new Date().toISOString()}
 - 请求ID: ${requestId}
@@ -226989,7 +227088,7 @@ function createWrappedHandler(name, handler, server) {
                 requestId,
                 ide: server.ide || process.env.INTEGRATION_IDE || ''
             });
-            const mcpVersion =  true ? "2.33.0" : 0;
+            const mcpVersion =  true ? "2.33.1" : 0;
             const requestIdSuffix = requestId ? `\n🆔 RequestId: ${requestId}` : '';
             const enhancedErrorMessage = `${errorMessage}${requestIdSuffix}\n\n📦 CloudBase MCP v${mcpVersion}\n🔗 遇到问题？请复制以下链接到浏览器打开\n即可自动携带错误详情快速创建 GitHub Issue：\n${issueLink}`;
             // 创建新的错误对象，保持原有的错误类型但更新消息
@@ -227027,6 +227126,7 @@ function createWrappedHandler(name, handler, server) {
                     inputParams: sanitizeArgs(args), // 添加入参上报
                     cloudBaseOptions: cloudBaseOptions, // 传递 CloudBase 配置（可能已更新）
                     ide: server.ide || process.env.INTEGRATION_IDE, // 传递集成IDE信息
+                    client: server.client || process.env.CLOUDBASE_MCP_CLIENT, // 传递 MCP client 来源标识
                     mcpClientInfo: (0, telemetry_js_1.readMcpClientInfoFromServer)(server),
                 }).catch(err => {
                     // 静默处理上报错误，不影响主要功能

package/dist/index.d.ts

@@ -98,6 +98,7 @@ export declare function createCloudBaseMcpServer(options?: {
     authOptions?: AuthOptions;
     cloudMode?: boolean;
     ide?: string;
+    client?: string;
     logger?: Logger;
     pluginsEnabled?: string[];
     pluginsDisabled?: string[];
@@ -190,6 +191,8 @@ export declare interface ExtendedMcpServer extends McpServer {
     cloudBaseOptions?: CloudBaseOptions;
     authOptions?: AuthOptions;
     ide?: string;
+    /** MCP client 来源标识（hosted 场景由上游解析注入，如 cursor / claude-code） */
+    client?: string;
     logger?: Logger;
     enabledPlugins?: string[];
     pluginOptions?: PluginOptions;
@@ -452,6 +455,7 @@ export declare const reportToolCall: (params: {
     inputParams?: any;
     cloudBaseOptions?: CloudBaseOptions;
     ide?: string;
+    client?: string;
     mcpClientInfo?: McpClientInfo;
 }) => Promise<void>;
 
@@ -462,6 +466,7 @@ export declare const reportToolkitLifecycle: (params: {
     error?: string;
     cloudBaseOptions?: CloudBaseOptions;
     ide?: string;
+    client?: string;
     mcpClientInfo?: McpClientInfo;
 }) => Promise<void>;