@szc-ft/mcp-szcd-client 0.11.0

package/scripts/postinstall.js

@@ -0,0 +1,203 @@
+#!/usr/bin/env node
+
+/**
+ * postinstall.js — 安装后编排器
+ *
+ * 支持两种模式：
+ *   --quick   快速模式（默认）：仅显示提示，不执行耗时操作
+ *   默认      完整模式：执行所有 IDE 配置
+ *
+ * 具体逻辑按 IDE 兼容方向抽离到 scripts/lib/ 下：
+ *   - common.js      通用工具（常量、安全保护、文件操作、配置读取）
+ *   - trae.js        Trae CLI / Trae CN 兼容逻辑
+ *   - claude-code.js Claude Code 兼容逻辑
+ *   - opencode.js    OpenCode 兼容逻辑
+ *   - qwen-code.js   Qwen Code 兼容逻辑
+ *   - qoder.js       Qoder CLI 兼容逻辑
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import * as common from "./lib/common.js";
+import { setupTrae } from "./lib/trae.js";
+import { setupClaudeCode } from "./lib/claude-code.js";
+import { setupOpenCode } from "./lib/opencode.js";
+import { setupQwenCode } from "./lib/qwen-code.js";
+import { setupQoder } from "./lib/qoder.js";
+
+// 递归守卫在 common.js 加载时已执行
+// 超时保护在 common.js 中已初始化
+
+const IS_QUICK = process.argv.includes("--quick");
+
+const deps = {
+    getMcpServerUrl: common.getMcpServerUrl,
+    getMcpServerName: common.getMcpServerName,
+    safeExecSync: common.safeExecSync,
+    isCommandAvailable: common.isCommandAvailable,
+    ensureDirectory: common.ensureDirectory,
+    copyFile: common.copyFile,
+    writeFile: common.writeFile,
+    SKILL_SOURCE: common.SKILL_SOURCE,
+    PROJECT_ROOT: common.PROJECT_ROOT,
+    PACKAGE_ROOT: common.PACKAGE_ROOT,
+};
+
+// ==================== 快速模式提示 ====================
+
+function showQuickMessage() {
+    console.log("\n" + "=".repeat(60));
+    console.log("  @szc-ft/mcp-szcd-component-helper installed!");
+    console.log("=".repeat(60));
+    console.log("\n⚡ Quick install mode — IDE setup skipped.");
+    console.log("\nTo complete setup, run one of:");
+    console.log("  npx szcd-mcp-setup        # Full setup (all IDEs)");
+    console.log("  npx szcd-mcp-server --stdio  # Start local server");
+    console.log("\n📖 Docs: https://github.com/szc-ft/szcd#readme\n");
+}
+
+// ==================== 配置文件 ====================
+
+function createConfigTemplate() {
+    const configPath = common.getConfigFilePath();
+
+    if (fs.existsSync(configPath)) {
+        console.log(`✓ Config file already exists: ${configPath}`);
+        return;
+    }
+
+    const configContent = {
+        MCP_SERVER_NAME: common.DEFAULT_MCP_SERVER_NAME,
+        MCP_SERVER_URL: common.getMcpServerUrl(),
+        MCP_TIMEOUT: 30000,
+        MCP_API_KEY: "",
+        _comment: "请修改 MCP_SERVER_URL 为您的 MCP 服务器地址",
+    };
+
+    common.writeFile(configPath, JSON.stringify(configContent, null, 2));
+}
+
+// ==================== 成功信息 ====================
+
+function showSuccessMessage(traeResult, claudeResult, qwenResult, qoderResult) {
+    const configPath = common.getConfigFilePath();
+    const projectRoot = common.PROJECT_ROOT;
+
+    console.log("\n" + "=".repeat(70));
+    console.log("  szcd-component-helper MCP Client Installed!");
+    console.log("=".repeat(70));
+    console.log("\n📦 Package: @szc-ft/mcp-szcd-component-helper");
+    console.log("\n🔗 This is a CLIENT package that connects to a remote MCP server.");
+
+    console.log("\n📚 Skill Locations:");
+    console.log(`   Trae CLI:     ${path.join(traeResult.skillsDirectory, common.getMcpServerName(), "SKILL.md")}`);
+    console.log(`   Claude Code:  ${path.join(claudeResult.skillsDirectory, common.getMcpServerName(), "SKILL.md")}`);
+    console.log(`   Qwen Code:    ${path.join(qwenResult.skillsDirectory, common.getMcpServerName(), "SKILL.md")}`);
+    console.log(`   Qoder CLI:    ${path.join(qoderResult.skillsDirectory, common.getMcpServerName(), "SKILL.md")}`);
+    if (traeResult.traeProjectInstalled) {
+        console.log(`   Trae Project: ${path.join(projectRoot, ".trae", "skills", common.getMcpServerName(), "SKILL.md")}`);
+    }
+    if (claudeResult.claudeProjectInstalled) {
+        console.log(`   Claude Project: ${path.join(projectRoot, ".claude", "skills", common.getMcpServerName(), "SKILL.md")}`);
+    }
+    if (qwenResult.qwenProjectInstalled) {
+        console.log(`   Qwen Project: ${path.join(projectRoot, ".qwen", "skills", common.getMcpServerName(), "SKILL.md")}`);
+    }
+    if (qoderResult.qoderProjectInstalled) {
+        console.log(`   Qoder Project: ${path.join(projectRoot, ".qoder", "skills", common.getMcpServerName(), "SKILL.md")}`);
+    }
+
+    console.log("\n⚙️  Configuration Files:");
+    console.log(`   1. Config file:         ${configPath}`);
+    console.log(`   2. Trae CLI:            via 'trae-cli mcp add-json'`);
+    console.log(`   3. Claude Code:         via 'claude mcp add'`);
+    console.log(`   4. Qwen Code:           via 'qwen extensions install'`);
+    console.log(`   5. Qoder CLI:           via 'qoder mcp add'`);
+
+    console.log("\n📝 Edit the config file to set your MCP server URL:");
+    console.log(`      "MCP_SERVER_URL": "http://YOUR_SERVER_IP:3456"`);
+    console.log("\n🌍 Or set environment variables:");
+    console.log('      export MCP_SERVER_URL="http://YOUR_SERVER_IP:3456"');
+
+    console.log("\n🔧 IDE/Agent Configuration:");
+    console.log("\n   For Claude Code (via CLI):");
+    console.log(`     claude mcp add --transport sse --scope user ${common.getMcpServerName()} ${common.getMcpServerUrl()}/sse`);
+    console.log("\n   For Trae CLI (via CLI):");
+    console.log(`     trae-cli mcp add-json ${common.getMcpServerName()} '{"type":"sse","url":"${common.getMcpServerUrl()}/sse"}'`);
+    console.log("\n   For Qwen Code (via CLI):");
+    console.log(`     qwen mcp add --transport sse --scope user ${common.getMcpServerName()} ${common.getMcpServerUrl()}/sse`);
+    console.log("\n   For Qoder CLI (via CLI):");
+    console.log(`     qoder mcp add ${common.getMcpServerName()} -s user -- ${common.getMcpServerUrl()}/sse`);
+
+    console.log("\n💡 Configuration Priority:");
+    console.log("   1. Environment variables (highest priority)");
+    console.log("   2. Config file (~/.szcd-mcp-config.json)");
+    console.log("   3. IDE mcp.json / settings.json");
+    console.log("   4. Default values (lowest priority)");
+
+    console.log("\n🌐 Default Server:");
+    console.log(`   ${common.getMcpServerUrl()}`);
+    console.log("   Contact your admin for the correct server URL");
+
+    console.log("\n📖 Documentation:");
+    console.log("   https://github.com/szc-ft/szcd#readme");
+    console.log("\n" + "=".repeat(70) + "\n");
+}
+
+// ==================== 主函数 ====================
+
+function main() {
+    try {
+        // ---- 快速模式：跳过所有耗时操作 ----
+        if (IS_QUICK) {
+            showQuickMessage();
+            return;
+        }
+
+        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}`);
+        }
+
+        // ---- 配置文件 ----
+        createConfigTemplate();
+        setupOpenCode(deps);
+
+        // ---- Trae CLI ----
+        console.log("\n🔧 Setting up Trae CLI compatibility...\n");
+        const traeResult = setupTrae(deps);
+
+        // ---- Claude Code ----
+        console.log("\n🔧 Setting up Claude Code compatibility...\n");
+        const claudeResult = setupClaudeCode(deps);
+
+        // ---- Qwen Code ----
+        console.log("\n🔧 Setting up Qwen Code compatibility...\n");
+        const qwenResult = setupQwenCode(deps);
+
+        // ---- Qoder CLI ----
+        console.log("\n🔧 Setting up Qoder CLI compatibility...\n");
+        const qoderResult = setupQoder(deps);
+
+        showSuccessMessage(traeResult, claudeResult, qwenResult, qoderResult);
+    } catch (error) {
+        console.error("\n❌ Error during installation:", error.message);
+        console.error("Please report this issue at: https://github.com/szc-ft/szcd/issues");
+        console.error("\n🔧 Manual setup instructions:");
+        console.error("1. Create skills directory: mkdir -p ~/.traecli/skills/szcd-component-helper");
+        console.error("2. Copy skill file: Copy SKILL.md from the package to ~/.trae-cn/skills/szcd-component-helper/");
+        console.error("3. Create config file: ~/.szcd-mcp-config.json with your server URL");
+        console.error("\n🔍 Debug information:");
+        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}`);
+        process.exit(1);
+    }
+}
+
+main();

package/scripts/update-mcp-url.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+
+/**
+ * szcd-mcp-update-url - 更新 MCP 服务器地址并同步 IDE 配置
+ *
+ * 用法:
+ *   node scripts/update-mcp-url.js <new-url>   用指定 URL 更新
+ *   node scripts/update-mcp-url.js             用配置文件中的 URL 同步 IDE
+ *
+ * 逻辑：
+ * 1. 确定目标 URL：用户输入 > 配置文件 > 报错退出
+ * 2. 与当前配置对比，相同则跳过
+ * 3. 更新 szcd 自身配置文件
+ * 4. 委托各 lib 模块同步对应 IDE 的 MCP 配置
+ *
+ * 同步的配置文件（由各 lib 模块负责）：
+ *   ~/.szcd-mcp-config.json       — szcd 自身配置（本文件处理）
+ *   ~/.traecli/trae_cli.yaml      — Trae CLI（lib/trae-cli.js）
+ *   ~/.trae-cn/mcp.json           — Trae CN IDE（lib/trae-ide.js）
+ *   ~/.claude.json                — Claude Code（lib/claude-code.js）
+ *   ~/.qwen/settings.json         — Qwen Code（lib/qwen-code.js）
+ *   ~/.qwen/extensions/.../qwen-extension.json — Qwen Code 扩展（lib/qwen-code.js）
+ *   ~/.qoder/settings.json         — Qoder CLI（lib/qoder.js）
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { syncMcpUrl as syncTraeCli } from "./lib/trae-cli.js";
+import { syncMcpUrl as syncTraeIde } from "./lib/trae-ide.js";
+import { syncMcpUrl as syncClaudeCode } from "./lib/claude-code.js";
+import { syncMcpUrl as syncQwenCode } from "./lib/qwen-code.js";
+import { syncMcpUrl as syncQoder } from "./lib/qoder.js";
+
+const DEFAULT_MCP_SERVER_NAME = "szcd-component-helper";
+const DEFAULT_MCP_SERVER_URL = "http://localhost:3456";
+
+// ==================== 工具函数 ====================
+
+function getHomeDir() {
+    const platform = os.platform();
+    if (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) { /* 忽略 */ }
+    return {};
+}
+
+function saveConfig(config) {
+    const configPath = getConfigFilePath();
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log(`✓ Updated config: ${configPath}`);
+}
+
+function getMcpServerName() {
+    const config = loadConfig();
+    return config.MCP_SERVER_NAME || DEFAULT_MCP_SERVER_NAME;
+}
+
+// ==================== 确定目标 URL ====================
+
+function resolveTargetUrl(inputUrl) {
+    if (inputUrl) {
+        if (!inputUrl.startsWith("http://") && !inputUrl.startsWith("https://")) {
+            console.error(`❌ Invalid URL: ${inputUrl}`);
+            console.error("   URL must start with http:// or https://");
+            process.exit(1);
+        }
+        return inputUrl;
+    }
+
+    const config = loadConfig();
+    if (config.MCP_SERVER_URL) {
+        return config.MCP_SERVER_URL;
+    }
+
+    console.error("❌ No URL provided and no MCP_SERVER_URL found in config file.");
+    console.error(`   Config file: ${getConfigFilePath()}`);
+    console.error("   Usage: node scripts/update-mcp-url.js <new-mcp-server-url>");
+    process.exit(1);
+}
+
+// ==================== 更新配置文件 ====================
+
+function updateConfigFile(targetUrl) {
+    const config = loadConfig();
+    const currentUrl = config.MCP_SERVER_URL;
+
+    if (currentUrl === targetUrl) {
+        console.log(`⏭️  Config file already up-to-date: MCP_SERVER_URL = ${targetUrl}`);
+        return false;
+    }
+
+    config.MCP_SERVER_URL = targetUrl;
+    saveConfig(config);
+    console.log(`  MCP_SERVER_URL: ${currentUrl || DEFAULT_MCP_SERVER_URL} → ${targetUrl}`);
+    return true;
+}
+
+// ==================== 主函数 ====================
+
+function main() {
+    const inputUrl = process.argv[2];
+    const targetUrl = resolveTargetUrl(inputUrl);
+    const serverName = getMcpServerName();
+
+    const config = loadConfig();
+    const currentUrl = config.MCP_SERVER_URL;
+
+    console.log(`\n🔄 Syncing MCP server URL to: ${targetUrl}\n`);
+
+    // 1. 更新 szcd 自身配置文件
+    updateConfigFile(targetUrl);
+
+    // 2. 委托各 lib 模块同步对应 IDE 配置
+    syncTraeCli(targetUrl, serverName);
+    syncTraeIde(targetUrl, serverName);
+    syncClaudeCode(targetUrl, serverName);
+    syncQwenCode(targetUrl, serverName);
+    syncQoder(targetUrl, serverName);
+
+    console.log(`\n✅ Done! MCP_SERVER_URL = ${targetUrl}`);
+    console.log(`\n📋 Updated configuration files:`);
+    console.log(`   ${getConfigFilePath()}`);
+    console.log(`   ${path.join(getHomeDir(), ".traecli", "trae_cli.yaml")}`);
+    console.log(`   ${path.join(getHomeDir(), ".trae-cn", "mcp.json")}`);
+    console.log(`   ${path.join(getHomeDir(), ".claude.json")}`);
+    console.log(`   ${path.join(getHomeDir(), ".qwen", "settings.json")}`);
+    console.log(`   ${path.join(getHomeDir(), ".qoder", "settings.json")}`);
+    console.log(`\n💡 Restart your IDE/CLI for changes to take effect.\n`);
+}
+
+main();