merge: 🔀 merge PR #255 and local docs updates

- Merge PR #255: fix login page redirect when switching account
- Update tools documentation (add callCloudApi, update version to 2.5.0)
- Add new IDE support (qoder, antigravity, kiro)
- Preserve existing setupContext and debug logging functionality

Author: binggg

mcp/src/auth.ts

@@ -1,38 +1,46 @@
-import { AuthSupevisor } from '@cloudbase/toolbox';
-import { debug } from './utils/logger.js';
+import { AuthSupevisor } from "@cloudbase/toolbox";
+import { debug } from "./utils/logger.js";
 
-const auth = AuthSupevisor.getInstance({
-})
+const auth = AuthSupevisor.getInstance({});
 
-export async function getLoginState() {
-    const {
-        TENCENTCLOUD_SECRETID,
-        TENCENTCLOUD_SECRETKEY,
-        TENCENTCLOUD_SESSIONTOKEN
-    } = process.env
-    debug('TENCENTCLOUD_SECRETID', { secretId: TENCENTCLOUD_SECRETID })
-    if (TENCENTCLOUD_SECRETID && TENCENTCLOUD_SECRETKEY) {
-        debug('loginByApiSecret')
-        return {
-            secretId: TENCENTCLOUD_SECRETID,
-            secretKey: TENCENTCLOUD_SECRETKEY,
-            token: TENCENTCLOUD_SESSIONTOKEN
-        }
-        // await auth.loginByApiSecret(TENCENTCLOUD_SECRETID, TENCENTCLOUD_SECRETKEY, TENCENTCLOUD_SESSIONTOKEN)
-    }
-    
-    const loginState = await auth.getLoginState()
-    if (!loginState) {
-       await auth.loginByWebAuth({})
-       const loginState = await auth.getLoginState()
-       debug('loginByWebAuth',loginState)
-       return loginState
-    } else {
-        return loginState
-    }
+export async function getLoginState(options?: {
+  fromCloudBaseLoginPage?: boolean;
+}) {
+  const {
+    TENCENTCLOUD_SECRETID,
+    TENCENTCLOUD_SECRETKEY,
+    TENCENTCLOUD_SESSIONTOKEN,
+  } = process.env;
+  debug("TENCENTCLOUD_SECRETID", { secretId: TENCENTCLOUD_SECRETID });
+  if (TENCENTCLOUD_SECRETID && TENCENTCLOUD_SECRETKEY) {
+    debug("loginByApiSecret");
+    return {
+      secretId: TENCENTCLOUD_SECRETID,
+      secretKey: TENCENTCLOUD_SECRETKEY,
+      token: TENCENTCLOUD_SESSIONTOKEN,
+    };
+    // await auth.loginByApiSecret(TENCENTCLOUD_SECRETID, TENCENTCLOUD_SECRETKEY, TENCENTCLOUD_SESSIONTOKEN)
+  }
+
+  const loginState = await auth.getLoginState();
+  if (!loginState) {
+    await auth.loginByWebAuth(
+      options?.fromCloudBaseLoginPage
+        ? {
+            getAuthUrl: (url) =>
+              `https://tcb.cloud.tencent.com/login?_redirect_uri=${encodeURIComponent(url)}`,
+          }
+        : {},
+    );
+    const loginState = await auth.getLoginState();
+    debug("loginByWebAuth", loginState);
+    return loginState;
+  } else {
+    return loginState;
+  }
 }
 
 export async function logout() {
-    const result = await auth.logout()
-    return result
-}
+  const result = await auth.logout();
+  return result;
+}

mcp/src/tools/env.ts

@@ -35,6 +35,8 @@ export function registerEnvTools(server: ExtendedMcpServer) {
       },
     },
     async ({ forceUpdate = false }: { forceUpdate?: boolean }) => {
+      let isSwitching = false;
+
       try {
         // 使用 while 循环处理用户切换账号的情况
         while (true) {
@@ -44,7 +46,12 @@ export function registerEnvTools(server: ExtendedMcpServer) {
             error,
             noEnvs,
             switch: switchAccount,
-          } = await _promptAndSetEnvironmentId(forceUpdate, server);
+          } = await _promptAndSetEnvironmentId(forceUpdate, {
+            server,
+            loginFromCloudBaseLoginPage: isSwitching,
+          });
+
+          isSwitching = Boolean(switchAccount);
 
           debug("login", {
             selectedEnvId,

mcp/src/tools/interactive.ts

@@ -195,30 +195,35 @@ export function registerInteractiveTools(server: ExtendedMcpServer) {
 // 封装了获取环境、提示选择、保存配置的核心逻辑
 export async function _promptAndSetEnvironmentId(
   autoSelectSingle: boolean,
-  server?: any,
+  options?: { server?: any; loginFromCloudBaseLoginPage?: boolean },
 ): Promise<{
   selectedEnvId: string | null;
   cancelled: boolean;
   error?: string;
   noEnvs?: boolean;
   switch?: boolean;
 }> {
+  const server = options?.server;
+
   // Initialize setup context for auto-provisioning flow
   let setupContext: EnvSetupContext = {};
 
   debug("[interactive] Starting _promptAndSetEnvironmentId", {
     autoSelectSingle,
-    hasServer: !!server
+    hasServer: !!server,
   });
 
   // 1. 确保用户已登录
   debug("[interactive] Step 1: Checking login state...");
-  const loginState = await getLoginState();
-  debug("[interactive] Login state:", { 
+  const loginState = await getLoginState({
+    fromCloudBaseLoginPage: options?.loginFromCloudBaseLoginPage,
+  });
+  debug("[interactive] Login state:", {
     hasLoginState: !!loginState,
-    hasUin: !!(loginState && typeof loginState === "object" && "uin" in loginState)
+    hasUin: !!(
+      loginState && typeof loginState === "object" && "uin" in loginState
+    ),
   });
-  
   if (!loginState) {
     debug("[interactive] User not logged in");
     return {