@szc-ft/mcp-szcd-client 0.13.1 → 0.14.0

package/scripts/lib/claude-code.js

@@ -131,7 +131,6 @@ function createClaudeCodeProjectConfig(deps) {
 // ==================== Skill 复制 ====================
 
 function copySkillToClaudeCode(deps, isProjectLevel = false) {
-    const skillName = deps.getMcpServerName();
     let claudeSkillsDir;
 
     if (isProjectLevel) {
@@ -140,18 +139,23 @@ function copySkillToClaudeCode(deps, isProjectLevel = false) {
         claudeSkillsDir = getClaudeCodeSkillsDirectory();
     }
 
-    const skillDir = path.join(claudeSkillsDir, skillName);
+    const skills = deps.discoverSkills();
+    let allOk = true;
 
-    try {
-        deps.ensureDirectory(skillDir);
-        const skillDest = path.join(skillDir, "SKILL.md");
-        deps.copyFile(deps.SKILL_SOURCE, skillDest);
-        console.log(`✓ Copied standard skill to Claude Code ${isProjectLevel ? 'project' : 'user'} directory: ${skillDir}`);
-        return true;
-    } catch (error) {
-        console.log(`⚠️  Failed to copy skill to Claude Code ${isProjectLevel ? 'project' : 'user'} directory: ${error.message}`);
-        return false;
+    for (const skill of skills) {
+        const skillDir = path.join(claudeSkillsDir, skill.name);
+        try {
+            deps.ensureDirectory(skillDir);
+            const skillDest = path.join(skillDir, "SKILL.md");
+            deps.copyFile(skill.sourcePath, skillDest);
+            console.log(`✓ Copied skill "${skill.name}" to Claude Code ${isProjectLevel ? 'project' : 'user'} directory: ${skillDir}`);
+        } catch (error) {
+            console.log(`⚠️  Failed to copy skill "${skill.name}" to Claude Code ${isProjectLevel ? 'project' : 'user'} directory: ${error.message}`);
+            allOk = false;
+        }
     }
+
+    return allOk;
 }
 
 // ==================== Agent 安装 ====================

package/scripts/lib/common.js

@@ -14,8 +14,36 @@ import { execSync } from "node:child_process";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
+// 默认值（需在 SKILL_SOURCE 之前定义）
+export const DEFAULT_MCP_SERVER_URL = "http://localhost:3456";
+export const DEFAULT_MCP_SERVER_NAME = "szcd-component-helper";
+
 export const PACKAGE_ROOT = path.resolve(__dirname, "..", "..");
-export const SKILL_SOURCE = path.join(PACKAGE_ROOT, "standard-skill", "SKILL.md");
+export const SKILLS_DIR = path.join(PACKAGE_ROOT, "standard-skill");
+
+// 向后兼容：保留 SKILL_SOURCE 指向主技能包
+export const SKILL_SOURCE = path.join(SKILLS_DIR, DEFAULT_MCP_SERVER_NAME, "SKILL.md");
+
+/**
+ * 扫描 standard-skill/ 目录下所有子目录，发现可安装的技能包。
+ * 目录结构约定：standard-skill/<skill-name>/SKILL.md
+ * 返回 [{ name, sourcePath }] 数组
+ */
+export function discoverSkills() {
+    const skills = [];
+    if (!fs.existsSync(SKILLS_DIR)) {
+        console.warn(`⚠️  Skills directory not found: ${SKILLS_DIR}`);
+        return skills;
+    }
+    for (const entry of fs.readdirSync(SKILLS_DIR, { withFileTypes: true })) {
+        if (!entry.isDirectory()) continue;
+        const skillFile = path.join(SKILLS_DIR, entry.name, "SKILL.md");
+        if (fs.existsSync(skillFile)) {
+            skills.push({ name: entry.name, sourcePath: skillFile });
+        }
+    }
+    return skills;
+}
 
 // 项目根目录：从 PACKAGE_ROOT 向上推导
 export function findProjectRoot() {
@@ -32,10 +60,6 @@ export function findProjectRoot() {
 }
 export const PROJECT_ROOT = findProjectRoot();
 
-// 默认值
-export const DEFAULT_MCP_SERVER_URL = "http://localhost:3456";
-export const DEFAULT_MCP_SERVER_NAME = "szcd-component-helper";
-
 // ==================== 安全保护 ====================
 
 export const RECURSION_GUARD_ENV = "SZCD_POSTINSTALL_RUNNING";

package/scripts/lib/qoder.js

@@ -171,7 +171,6 @@ function syncQoderSettings(deps) {
 // ==================== Skill 复制 ====================
 
 function copySkillToQoder(deps, isProjectLevel = false) {
-    const skillName = deps.getMcpServerName();
     let qoderSkillsDir;
 
     if (isProjectLevel) {
@@ -180,18 +179,23 @@ function copySkillToQoder(deps, isProjectLevel = false) {
         qoderSkillsDir = getQoderSkillsDirectory();
     }
 
-    const skillDir = path.join(qoderSkillsDir, skillName);
+    const skills = deps.discoverSkills();
+    let allOk = true;
 
-    try {
-        deps.ensureDirectory(skillDir);
-        const skillDest = path.join(skillDir, "SKILL.md");
-        deps.copyFile(deps.SKILL_SOURCE, skillDest);
-        console.log(`✓ Copied skill to Qoder ${isProjectLevel ? "project" : "user"} directory: ${skillDir}`);
-        return true;
-    } catch (error) {
-        console.log(`⚠️  Failed to copy skill to Qoder ${isProjectLevel ? "project" : "user"} directory: ${error.message}`);
-        return false;
+    for (const skill of skills) {
+        const skillDir = path.join(qoderSkillsDir, skill.name);
+        try {
+            deps.ensureDirectory(skillDir);
+            const skillDest = path.join(skillDir, "SKILL.md");
+            deps.copyFile(skill.sourcePath, skillDest);
+            console.log(`✓ Copied skill "${skill.name}" to Qoder ${isProjectLevel ? "project" : "user"} directory: ${skillDir}`);
+        } catch (error) {
+            console.log(`⚠️  Failed to copy skill "${skill.name}" to Qoder ${isProjectLevel ? "project" : "user"} directory: ${error.message}`);
+            allOk = false;
+        }
     }
+
+    return allOk;
 }
 
 // ==================== Agent 安装 ====================

package/scripts/lib/trae-cli.js

@@ -169,7 +169,6 @@ export function getTraeCliSkillsDirectory() {
 }
 
 export function copySkillToTraeCli(deps, isProjectLevel = false) {
-    const skillName = deps.getMcpServerName();
     let traeCliSkillsDir;
 
     if (isProjectLevel) {
@@ -178,18 +177,23 @@ export function copySkillToTraeCli(deps, isProjectLevel = false) {
         traeCliSkillsDir = getTraeCliSkillsDirectory();
     }
 
-    const skillDir = path.join(traeCliSkillsDir, skillName);
+    const skills = deps.discoverSkills();
+    let allOk = true;
 
-    try {
-        deps.ensureDirectory(skillDir);
-        const skillDest = path.join(skillDir, "SKILL.md");
-        deps.copyFile(deps.SKILL_SOURCE, skillDest);
-        console.log(`✓ Copied skill to Trae CLI ${isProjectLevel ? 'project' : 'user'} directory: ${skillDir}`);
-        return true;
-    } catch (error) {
-        console.log(`⚠️  Failed to copy skill to Trae CLI ${isProjectLevel ? 'project' : 'user'} directory: ${error.message}`);
-        return false;
+    for (const skill of skills) {
+        const skillDir = path.join(traeCliSkillsDir, skill.name);
+        try {
+            deps.ensureDirectory(skillDir);
+            const skillDest = path.join(skillDir, "SKILL.md");
+            deps.copyFile(skill.sourcePath, skillDest);
+            console.log(`✓ Copied skill "${skill.name}" to Trae CLI ${isProjectLevel ? 'project' : 'user'} directory: ${skillDir}`);
+        } catch (error) {
+            console.log(`⚠️  Failed to copy skill "${skill.name}" to Trae CLI ${isProjectLevel ? 'project' : 'user'} directory: ${error.message}`);
+            allOk = false;
+        }
     }
+
+    return allOk;
 }
 
 // ==================== Slash Command 安装（Trae CLI） ====================

package/scripts/lib/trae-ide.js

@@ -146,7 +146,6 @@ export function syncMcpUrl(targetUrl, serverName) {
 // ==================== Skill 复制 ====================
 
 export function copySkillToTrae(deps, isProjectLevel = false) {
-    const skillName = deps.getMcpServerName();
     let traeSkillsDir;
 
     if (isProjectLevel) {
@@ -155,18 +154,23 @@ export function copySkillToTrae(deps, isProjectLevel = false) {
         traeSkillsDir = getTraeSkillsDirectory();
     }
 
-    const skillDir = path.join(traeSkillsDir, skillName);
+    const skills = deps.discoverSkills();
+    let allOk = true;
 
-    try {
-        deps.ensureDirectory(skillDir);
-        const skillDest = path.join(skillDir, "SKILL.md");
-        deps.copyFile(deps.SKILL_SOURCE, skillDest);
-        console.log(`✓ Copied standard skill to Trae ${isProjectLevel ? 'project' : 'user'} directory: ${skillDir}`);
-        return true;
-    } catch (error) {
-        console.log(`⚠️  Failed to copy skill to Trae ${isProjectLevel ? 'project' : 'user'} directory: ${error.message}`);
-        return false;
+    for (const skill of skills) {
+        const skillDir = path.join(traeSkillsDir, skill.name);
+        try {
+            deps.ensureDirectory(skillDir);
+            const skillDest = path.join(skillDir, "SKILL.md");
+            deps.copyFile(skill.sourcePath, skillDest);
+            console.log(`✓ Copied skill "${skill.name}" to Trae ${isProjectLevel ? 'project' : 'user'} directory: ${skillDir}`);
+        } catch (error) {
+            console.log(`⚠️  Failed to copy skill "${skill.name}" to Trae ${isProjectLevel ? 'project' : 'user'} directory: ${error.message}`);
+            allOk = false;
+        }
     }
+
+    return allOk;
 }
 
 // ==================== Agent 复制（Trae IDE） ====================
@@ -209,3 +213,47 @@ export function copyTraeIdeAgent(deps, isProjectLevel = false) {
     return copied > 0;
 }
 
+// ==================== Slash Command 安装（Trae IDE） ====================
+
+export function getTraeIdeCommandsDirectory() {
+    return path.join(getTraeUserDirectory(), "commands");
+}
+
+export function installTraeIdeSlashCommand(deps) {
+    const commandsSourceDir = path.join(deps.PACKAGE_ROOT, "commands");
+    if (!fs.existsSync(commandsSourceDir)) {
+        console.log("⚠️  Commands source directory not found, skipping Trae IDE");
+        return;
+    }
+
+    const commandFiles = fs.readdirSync(commandsSourceDir).filter(f => f.endsWith(".md"));
+    if (commandFiles.length === 0) {
+        console.log("⚠️  No command files found, skipping Trae IDE");
+        return;
+    }
+
+    const traeIdeCommandsDir = getTraeIdeCommandsDirectory();
+    try {
+        deps.ensureDirectory(traeIdeCommandsDir);
+        for (const file of commandFiles) {
+            const commandSource = path.join(commandsSourceDir, file);
+            const commandDest = path.join(traeIdeCommandsDir, file);
+
+            // 如果目标已存在且内容不同，跳过（用户可能已修改）
+            if (fs.existsSync(commandDest)) {
+                const existingContent = fs.readFileSync(commandDest, "utf8").trim();
+                const sourceContent = fs.readFileSync(commandSource, "utf8").trim();
+                if (existingContent !== sourceContent) {
+                    console.log(`⏭️  Skipping Trae IDE command ${file}: already exists (user modified)`);
+                    continue;
+                }
+            }
+
+            deps.copyFile(commandSource, commandDest);
+            console.log(`✓ Installed Trae IDE slash command: /${file.replace(".md", "")}`);
+        }
+    } catch (error) {
+        console.log(`⚠️  Failed to install Trae IDE slash commands: ${error.message}`);
+    }
+}
+

package/scripts/lib/trae.js

@@ -4,7 +4,7 @@
  * 负责编排 Trae CLI 与 Trae IDE 的初始化流程。
  * 具体逻辑已按方向拆离到：
  *   - trae-cli.js   Trae CLI 专属逻辑（YAML、trae-cli 命令、.traecli/skills/agents/commands）
- *   - trae-ide.js   Trae IDE 专属逻辑（mcp.json、.trae-cn/skills、.trae-cn/agents）
+ *   - trae-ide.js   Trae IDE 专属逻辑（mcp.json、.trae-cn/skills、.trae-cn/agents、.trae-cn/commands）
  *
  * 导出 setupTrae(deps) 供 postinstall.js 调用。
  * deps 需包含: { getMcpServerUrl, getMcpServerName, safeExecSync, isCommandAvailable, ensureDirectory, copyFile, writeFile, SKILL_SOURCE, PROJECT_ROOT, PACKAGE_ROOT }
@@ -23,6 +23,7 @@ import {
     copySkillToTrae,
     copyTraeIdeAgent,
     getTraeAgentsDirectory,
+    installTraeIdeSlashCommand,
 } from "./trae-ide.js";
 
 // ==================== 导出 ====================
@@ -31,6 +32,7 @@ export function setupTrae(deps) {
     // ---- Trae IDE ----
     createTraeIdeConfig(deps);
     copySkillToTrae(deps, false);
+    installTraeIdeSlashCommand(deps);
     // IDE 暂不支持 agent，跳过
     // copyTraeIdeAgent(deps, false);
 

package/scripts/postinstall.js

@@ -39,6 +39,7 @@ const deps = {
     ensureDirectory: common.ensureDirectory,
     copyFile: common.copyFile,
     writeFile: common.writeFile,
+    discoverSkills: common.discoverSkills,
     SKILL_SOURCE: common.SKILL_SOURCE,
     PROJECT_ROOT: common.PROJECT_ROOT,
     PACKAGE_ROOT: common.PACKAGE_ROOT,
@@ -158,11 +159,12 @@ function main() {
         console.log("\n🔧 Setting up szcd-component-helper client...\n");
 
         console.log(`📁 Package root: ${common.PACKAGE_ROOT}`);
-        console.log(`📄 Skill source: ${common.SKILL_SOURCE}`);
 
-        if (!fs.existsSync(common.SKILL_SOURCE)) {
-            throw new Error(`Skill source file not found: ${common.SKILL_SOURCE}`);
+        const discoveredSkills = common.discoverSkills();
+        if (discoveredSkills.length === 0) {
+            throw new Error(`No skills found in ${common.SKILLS_DIR}. Expected subdirectories with SKILL.md files.`);
         }
+        console.log(`📄 Found ${discoveredSkills.length} skill(s): ${discoveredSkills.map(s => s.name).join(", ")}`);
 
         // ---- 配置文件 ----
         createConfigTemplate();
@@ -196,7 +198,7 @@ function main() {
         console.error(`- Node version: ${process.version}`);
         console.error(`- Platform: ${process.platform}`);
         console.error(`- Package root: ${common.PACKAGE_ROOT}`);
-        console.error(`- Skill source: ${common.SKILL_SOURCE}`);
+        console.error(`- Skills directory: ${common.SKILLS_DIR}`);
         process.exit(1);
     }
 }

package/scripts/update-api-config.js

@@ -0,0 +1,272 @@
+#!/usr/bin/env node
+
+/**
+ * szcd-mcp-api-config - 管理 API 工具（YApi + Swagger）的默认配置
+ *
+ * 用法:
+ *   npx szcd-mcp-api-config get                    查看当前 API 配置
+ *   npx szcd-mcp-api-config set --baseUrl=xxx       设置 YApi 基础地址
+ *   npx szcd-mcp-api-config set --account=xxx       设置 YApi 登录账号
+ *   npx szcd-mcp-api-config set --password=xxx      设置 YApi 密码
+ *   npx szcd-mcp-api-config set --cookies=xxx       设置 YApi Cookie
+ *   npx szcd-mcp-api-config set --swgUser=xxx       设置 Swagger 默认用户名
+ *   npx szcd-mcp-api-config set --swgPass=xxx       设置 Swagger 默认密码
+ *   npx szcd-mcp-api-config set --baseUrl=xxx --account=yyy --password=zzz  批量设置
+ *   npx szcd-mcp-api-config clear                   清除所有 API 配置
+ *
+ * 配置保存在 ~/.szcd-mcp-config.json 中，字段名：
+ *   YAPI_BASE_URL             — YApi 基础地址（如 http://yapi.smartcitysz.work）
+ *   YAPI_ACCOUNT              — YApi 登录账号/邮箱
+ *   YAPI_PASSWORD             — YApi 密码（敏感）
+ *   YAPI_COOKIES              — YApi Cookie 字符串（敏感，优先使用）
+ *   SWAGGER_DEFAULT_USERNAME  — Swagger 默认鉴权用户名
+ *   SWAGGER_DEFAULT_PASSWORD  — Swagger 默认鉴权密码（敏感，留空则跳过鉴权）
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+
+// ==================== 工具函数 ====================
+
+function getHomeDir() {
+    if (os.platform() === "win32") {
+        return process.env.USERPROFILE || process.env.HOME || os.homedir();
+    }
+    return process.env.HOME || os.homedir();
+}
+
+function getConfigFilePath() {
+    return path.join(getHomeDir(), ".szcd-mcp-config.json");
+}
+
+function loadConfig() {
+    const configPath = getConfigFilePath();
+    try {
+        if (fs.existsSync(configPath)) {
+            return JSON.parse(fs.readFileSync(configPath, "utf8"));
+        }
+    } catch (error) {
+        console.error(`Failed to read config: ${error.message}`);
+    }
+    return {};
+}
+
+function saveConfig(config) {
+    const configPath = getConfigFilePath();
+    try {
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+        return true;
+    } catch (error) {
+        console.error(`Failed to write config: ${error.message}`);
+        return false;
+    }
+}
+
+function maskValue(value) {
+    if (!value) return "(未设置)";
+    if (value.length <= 6) return "***";
+    return value.substring(0, 4) + "***";
+}
+
+function parseArgs(argv) {
+    const args = {
+        action: null,
+        baseUrl: null,
+        account: null,
+        password: null,
+        cookies: null,
+        swgUser: null,
+        swgPass: null,
+    };
+    const positional = [];
+
+    for (let i = 2; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith("--")) {
+            const eqIdx = arg.indexOf("=");
+            if (eqIdx !== -1) {
+                const key = arg.slice(2, eqIdx);
+                const value = arg.slice(eqIdx + 1);
+                if (key === "baseUrl" || key === "base-url") args.baseUrl = value;
+                if (key === "account") args.account = value;
+                if (key === "password") args.password = value;
+                if (key === "cookies") args.cookies = value;
+                if (key === "swgUser" || key === "swg-user") args.swgUser = value;
+                if (key === "swgPass" || key === "swg-pass") args.swgPass = value;
+            }
+        } else {
+            positional.push(arg);
+        }
+    }
+
+    args.action = positional[0] || "get";
+    return args;
+}
+
+// ==================== 命令实现 ====================
+
+function cmdGet() {
+    const config = loadConfig();
+
+    console.log(`\nAPI 工具配置 (${getConfigFilePath()})\n`);
+    console.log(`  [YApi]`);
+    console.log(`  YAPI_BASE_URL             : ${config.YAPI_BASE_URL || "(未设置)"}`);
+    console.log(`  YAPI_ACCOUNT              : ${config.YAPI_ACCOUNT || "(未设置)"}`);
+    console.log(`  YAPI_PASSWORD             : ${maskValue(config.YAPI_PASSWORD)}`);
+    console.log(`  YAPI_COOKIES              : ${maskValue(config.YAPI_COOKIES)}`);
+    console.log(`\n  [Swagger]`);
+    console.log(`  SWAGGER_DEFAULT_USERNAME  : ${config.SWAGGER_DEFAULT_USERNAME || "(未设置)"}`);
+    console.log(`  SWAGGER_DEFAULT_PASSWORD  : ${maskValue(config.SWAGGER_DEFAULT_PASSWORD)}`);
+    console.log(`\n配置后，api_tool fetch 操作可自动读取认证信息。`);
+    console.log(`   用法: npx szcd-mcp-api-config set --baseUrl=xxx --account=yyy --cookies=zzz --swgUser=admin --swgPass=xxx\n`);
+}
+
+function cmdSet(baseUrl, account, password, cookies, swgUser, swgPass) {
+    const config = loadConfig();
+    let changed = false;
+
+    if (baseUrl) {
+        const old = config.YAPI_BASE_URL || "(未设置)";
+        config.YAPI_BASE_URL = baseUrl;
+        console.log(`  YAPI_BASE_URL             : ${old} -> ${baseUrl}`);
+        changed = true;
+    }
+    if (account) {
+        const old = config.YAPI_ACCOUNT || "(未设置)";
+        config.YAPI_ACCOUNT = account;
+        console.log(`  YAPI_ACCOUNT              : ${old} -> ${account}`);
+        changed = true;
+    }
+    if (password) {
+        const old = maskValue(config.YAPI_PASSWORD);
+        config.YAPI_PASSWORD = password;
+        console.log(`  YAPI_PASSWORD             : ${old} -> ${maskValue(password)}`);
+        changed = true;
+    }
+    if (cookies) {
+        const old = maskValue(config.YAPI_COOKIES);
+        config.YAPI_COOKIES = cookies;
+        console.log(`  YAPI_COOKIES              : ${old} -> ${maskValue(cookies)}`);
+        changed = true;
+    }
+    if (swgUser) {
+        const old = config.SWAGGER_DEFAULT_USERNAME || "(未设置)";
+        config.SWAGGER_DEFAULT_USERNAME = swgUser;
+        console.log(`  SWAGGER_DEFAULT_USERNAME  : ${old} -> ${swgUser}`);
+        changed = true;
+    }
+    if (swgPass) {
+        const old = maskValue(config.SWAGGER_DEFAULT_PASSWORD);
+        config.SWAGGER_DEFAULT_PASSWORD = swgPass;
+        console.log(`  SWAGGER_DEFAULT_PASSWORD  : ${old} -> ${maskValue(swgPass)}`);
+        changed = true;
+    }
+
+    if (!changed) {
+        console.log("\n未提供任何要设置的参数。用法:");
+        console.log("   npx szcd-mcp-api-config set --baseUrl=xxx --account=yyy --password=zzz --cookies=ccc --swgUser=admin --swgPass=xxx\n");
+        return false;
+    }
+
+    if (saveConfig(config)) {
+        console.log(`\n配置已保存。`);
+        console.log(`   YAPI_BASE_URL             : ${config.YAPI_BASE_URL || "(未设置)"}`);
+        console.log(`   YAPI_ACCOUNT              : ${config.YAPI_ACCOUNT || "(未设置)"}`);
+        console.log(`   YAPI_PASSWORD             : ${maskValue(config.YAPI_PASSWORD)}`);
+        console.log(`   YAPI_COOKIES              : ${maskValue(config.YAPI_COOKIES)}`);
+        console.log(`   SWAGGER_DEFAULT_USERNAME  : ${config.SWAGGER_DEFAULT_USERNAME || "(未设置)"}`);
+        console.log(`   SWAGGER_DEFAULT_PASSWORD  : ${maskValue(config.SWAGGER_DEFAULT_PASSWORD)}\n`);
+        return true;
+    }
+    console.log("\n保存配置失败。\n");
+    return false;
+}
+
+function cmdClear() {
+    const config = loadConfig();
+    const hadBaseUrl = !!config.YAPI_BASE_URL;
+    const hadAccount = !!config.YAPI_ACCOUNT;
+    const hadPassword = !!config.YAPI_PASSWORD;
+    const hadCookies = !!config.YAPI_COOKIES;
+    const hadSwgUser = !!config.SWAGGER_DEFAULT_USERNAME;
+    const hadSwgPass = !!config.SWAGGER_DEFAULT_PASSWORD;
+
+    if (!hadBaseUrl && !hadAccount && !hadPassword && !hadCookies && !hadSwgUser && !hadSwgPass) {
+        console.log("\n没有 API 配置需要清除。\n");
+        return false;
+    }
+
+    delete config.YAPI_BASE_URL;
+    delete config.YAPI_ACCOUNT;
+    delete config.YAPI_PASSWORD;
+    delete config.YAPI_COOKIES;
+    delete config.SWAGGER_DEFAULT_USERNAME;
+    delete config.SWAGGER_DEFAULT_PASSWORD;
+
+    if (saveConfig(config)) {
+        console.log("\n已清除 API 配置。\n");
+        return true;
+    }
+    console.log("\n清除配置失败。\n");
+    return false;
+}
+
+// ==================== 帮助信息 ====================
+
+function printHelp() {
+    console.log(`
+Usage: npx szcd-mcp-api-config <command> [options]
+
+Commands:
+  get                          查看当前 API 工具配置
+  set [options]                设置 YApi / Swagger 配置项
+  clear                        清除所有 API 配置
+
+Options for 'set':
+  --baseUrl=<url>              YApi 基础地址，如 http://yapi.smartcitysz.work
+  --account=<email>            YApi 登录账号/邮箱
+  --password=<string>          YApi 密码（敏感）
+  --cookies=<string>           YApi Cookie 字符串（敏感，优先使用）
+  --swgUser=<string>           Swagger 默认鉴权用户名
+  --swgPass=<string>           Swagger 默认鉴权密码（敏感，留空则跳过鉴权）
+
+Examples:
+  npx szcd-mcp-api-config get
+  npx szcd-mcp-api-config set --baseUrl=http://yapi.smartcitysz.work
+  npx szcd-mcp-api-config set --account=xxx@smartcitysz.work --password=xxx
+  npx szcd-mcp-api-config set --cookies="_yapi_token=xxx; _yapi_uid=xxx"
+  npx szcd-mcp-api-config set --swgUser=admin --swgPass=xxx
+  npx szcd-mcp-api-config set --baseUrl=xxx --account=yyy --swgUser=admin --swgPass=zzz
+  npx szcd-mcp-api-config clear
+
+Config file: ~/.szcd-mcp-config.json
+`);
+}
+
+// ==================== 主函数 ====================
+
+function main() {
+    const args = parseArgs(process.argv);
+
+    if (args.action === "help" || args.action === "-h" || args.action === "--help") {
+        printHelp();
+        process.exit(0);
+    }
+
+    if (args.action === "get") {
+        cmdGet();
+    } else if (args.action === "set") {
+        const ok = cmdSet(args.baseUrl, args.account, args.password, args.cookies, args.swgUser, args.swgPass);
+        process.exit(ok ? 0 : 1);
+    } else if (args.action === "clear") {
+        const ok = cmdClear();
+        process.exit(ok ? 0 : 1);
+    } else {
+        console.error(`Unknown command: ${args.action}`);
+        printHelp();
+        process.exit(1);
+    }
+}
+
+main();