@szc-ft/mcp-szcd-client 0.11.0

package/scripts/lib/claude-code.js

@@ -0,0 +1,342 @@
+/**
+ * claude-code.js — Claude Code 全部兼容逻辑
+ *
+ * 导出 setupClaudeCode(deps) 供 postinstall.js 调用。
+ * deps 需包含: { getMcpServerUrl, getMcpServerName, safeExecSync, isCommandAvailable, ensureDirectory, copyFile, SKILL_SOURCE, PROJECT_ROOT }
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { execSync } from "node:child_process";
+
+// ==================== 路径工具 ====================
+
+function getHomeDir() {
+    if (os.platform() === "win32") {
+        return process.env.USERPROFILE || process.env.HOME || os.homedir();
+    }
+    return process.env.HOME || os.homedir();
+}
+
+function getClaudeCodeUserDirectory() {
+    const homeDir = getHomeDir();
+    if (!homeDir) throw new Error("Home directory not found");
+    return path.join(homeDir, ".claude");
+}
+
+function getClaudeCodeSkillsDirectory() {
+    return path.join(getClaudeCodeUserDirectory(), "skills");
+}
+
+function getClaudeCodeAgentsDirectory() {
+    return path.join(getClaudeCodeUserDirectory(), "agents");
+}
+
+function getClaudeCodeConfigPath() {
+    return path.join(getHomeDir(), ".claude.json");
+}
+
+// ==================== 直接文件操作 ====================
+
+function syncClaudeCodeConfig(deps) {
+    const configPath = getClaudeCodeConfigPath();
+    const sseUrl = `${deps.getMcpServerUrl()}/sse`;
+    const serverName = deps.getMcpServerName();
+
+    let config = {};
+    if (fs.existsSync(configPath)) {
+        try {
+            config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+        } catch { /* 忽略 */ }
+    }
+
+    if (!config.mcpServers) config.mcpServers = {};
+
+    const current = config.mcpServers[serverName];
+    if (current && current.type === "sse" && current.url === sseUrl) {
+        console.log(`✓ Claude Code ~/.claude.json already up-to-date: ${sseUrl}`);
+        return;
+    }
+
+    config.mcpServers[serverName] = {
+        type: "sse",
+        url: sseUrl,
+    };
+
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log(`✓ Updated Claude Code ~/.claude.json: ${sseUrl}`);
+}
+
+// ==================== CLI 命令同步 ====================
+
+function createClaudeCodeUserConfig(deps) {
+    if (deps.isCommandAvailable("claude")) {
+        const sseUrl = `${deps.getMcpServerUrl()}/sse`;
+        const serverName = deps.getMcpServerName();
+
+        const result = deps.safeExecSync(`claude mcp add --transport sse --scope user ${serverName} ${sseUrl}`);
+        if (result === true) {
+            console.log(`✓ Claude Code user MCP server added via CLI: ${serverName} (${sseUrl})`);
+        } else if (result === "already_exists") {
+            console.log(`✓ Claude Code user MCP server already configured: ${serverName} (${sseUrl})`);
+        } else {
+            if (deps.safeExecSync(`claude mcp remove --scope user ${serverName} 2>/dev/null`) &&
+                deps.safeExecSync(`claude mcp add --transport sse --scope user ${serverName} ${sseUrl}`)) {
+                console.log(`✓ Claude Code user MCP server updated via CLI: ${serverName} (${sseUrl})`);
+            } else {
+                console.warn(`⚠️  Failed to configure Claude Code MCP server via CLI (config file will be updated directly)`);
+            }
+        }
+    } else {
+        console.log("⏭️  Skipping Claude Code CLI sync: claude command not found");
+    }
+
+    syncClaudeCodeConfig(deps);
+}
+
+function createClaudeCodeProjectConfig(deps) {
+    if (!deps.isCommandAvailable("claude")) {
+        console.log("⏭️  Skipping Claude Code project config: claude command not found");
+        return false;
+    }
+
+    const sseUrl = `${deps.getMcpServerUrl()}/sse`;
+    const serverName = deps.getMcpServerName();
+
+    const result = deps.safeExecSync(`claude mcp add --transport sse --scope project ${serverName} ${sseUrl}`);
+    if (result === true) {
+        console.log(`✓ Claude Code project MCP server added via CLI: ${serverName} (${sseUrl})`);
+        return true;
+    }
+    if (result === "already_exists") {
+        console.log(`✓ Claude Code project MCP server already configured: ${serverName} (${sseUrl})`);
+        return true;
+    }
+
+    if (deps.safeExecSync(`claude mcp remove --scope project ${serverName} 2>/dev/null`) &&
+        deps.safeExecSync(`claude mcp add --transport sse --scope project ${serverName} ${sseUrl}`)) {
+        console.log(`✓ Claude Code project MCP server updated via CLI: ${serverName} (${sseUrl})`);
+        return true;
+    }
+
+    console.warn(`⚠️  Failed to configure Claude Code project MCP server, please configure manually:`);
+    console.warn(`   claude mcp add --transport sse --scope project ${serverName} ${sseUrl}`);
+    return false;
+}
+
+// ==================== Skill 复制 ====================
+
+function copySkillToClaudeCode(deps, isProjectLevel = false) {
+    const skillName = deps.getMcpServerName();
+    let claudeSkillsDir;
+
+    if (isProjectLevel) {
+        claudeSkillsDir = path.join(deps.PROJECT_ROOT, ".claude", "skills");
+    } else {
+        claudeSkillsDir = getClaudeCodeSkillsDirectory();
+    }
+
+    const skillDir = path.join(claudeSkillsDir, skillName);
+
+    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;
+    }
+}
+
+// ==================== Agent 安装 ====================
+
+function copyAgentToClaudeCode(deps, isProjectLevel = false) {
+    const agentsSourceDir = path.join(deps.PACKAGE_ROOT, "agents");
+    if (!fs.existsSync(agentsSourceDir)) {
+        console.log("⏭️  Skipping agent install: agents source directory not found");
+        return false;
+    }
+
+    let claudeAgentsDir;
+    if (isProjectLevel) {
+        claudeAgentsDir = path.join(deps.PROJECT_ROOT, ".claude", "agents");
+    } else {
+        claudeAgentsDir = getClaudeCodeAgentsDirectory();
+    }
+
+    // Claude Code 只复制不含 .trae. 的 .md 文件（原生格式）
+    const agentFiles = fs.readdirSync(agentsSourceDir).filter(f => f.endsWith(".md") && !f.includes(".trae."));
+    let copied = 0;
+
+    for (const agentFile of agentFiles) {
+        const sourcePath = path.join(agentsSourceDir, agentFile);
+        const destPath = path.join(claudeAgentsDir, agentFile);
+
+        try {
+            deps.ensureDirectory(claudeAgentsDir);
+            deps.copyFile(sourcePath, destPath);
+            copied++;
+        } catch (error) {
+            console.log(`⚠️  Failed to copy agent ${agentFile}: ${error.message}`);
+        }
+    }
+
+    if (copied > 0) {
+        console.log(`✓ Copied ${copied} agent(s) to Claude Code ${isProjectLevel ? 'project' : 'user'} directory: ${claudeAgentsDir}`);
+        return true;
+    }
+    return false;
+}
+
+// ==================== Slash Command 安装 ====================
+
+function installClaudeCodeSlashCommand(deps) {
+    const commandSource = path.join(deps.PACKAGE_ROOT, "commands", "szcd-mcp-url.md");
+    if (!fs.existsSync(commandSource)) {
+        console.log("⚠️  Slash command source not found, skipping Claude Code");
+        return;
+    }
+
+    // Claude Code：项目级 .claude/commands/
+    const claudeDir = path.join(deps.PROJECT_ROOT, ".claude");
+    const claudeCommandsDir = path.join(claudeDir, "commands");
+    const commandDest = path.join(claudeCommandsDir, "szcd-mcp-url.md");
+
+    if (fs.existsSync(claudeDir) && !fs.statSync(claudeDir).isDirectory()) {
+        console.log(`⚠️  Skipping Claude Code slash command: ${claudeDir} exists but is not a directory`);
+        return;
+    }
+
+    try {
+        deps.ensureDirectory(claudeCommandsDir);
+
+        if (fs.existsSync(commandDest)) {
+            const existingContent = fs.readFileSync(commandDest, "utf8").trim();
+            const sourceContent = fs.readFileSync(commandSource, "utf8").trim();
+            if (existingContent !== sourceContent) {
+                console.log(`⏭️  Skipping Claude Code slash command: ${commandDest} already exists (user modified)`);
+                return;
+            }
+        }
+
+        deps.copyFile(commandSource, commandDest);
+        console.log(`✓ Installed Claude Code project slash command: /szcd-mcp-url`);
+    } catch (error) {
+        console.log(`⚠️  Failed to install Claude Code slash command: ${error.message}`);
+    }
+}
+
+// ==================== MCP URL 同步（供 update-mcp-url.js 调用） ====================
+
+/**
+ * 不依赖 deps 的 CLI 可用性检测
+ */
+function isCommandAvailable(cmd) {
+    try {
+        execSync(`which ${cmd} 2>/dev/null`, { stdio: "pipe", timeout: 3000 });
+        return true;
+    } catch {
+        return false;
+    }
+}
+
+/**
+ * 不依赖 deps 的安全命令执行
+ */
+function safeExecSync(command) {
+    try {
+        execSync(command, { stdio: "pipe", timeout: 10000 });
+        return true;
+    } catch (e) {
+        const stderr = e.stderr?.toString() || "";
+        if (stderr.includes("already exists")) return "already_exists";
+        return false;
+    }
+}
+
+/**
+ * 同步 Claude Code 配置中的 MCP 服务器 URL
+ * @param {string} targetUrl - 新的 MCP 服务器基础 URL（如 http://localhost:3456）
+ * @param {string} serverName - MCP 服务器名称
+ */
+export function syncMcpUrl(targetUrl, serverName) {
+    const sseUrl = `${targetUrl}/sse`;
+
+    // 1. CLI 命令同步
+    if (isCommandAvailable("claude")) {
+        safeExecSync(`claude mcp remove --scope user ${serverName} 2>/dev/null`);
+        const result = safeExecSync(`claude mcp add --transport sse --scope user ${serverName} ${sseUrl}`);
+        if (result === true || result === "already_exists") {
+            console.log(`✓ Claude Code CLI synced: ${sseUrl}`);
+        } else {
+            console.warn(`⚠️  Claude Code CLI sync failed (~/.claude.json will be updated directly)`);
+        }
+    } else {
+        console.log("⏭️  Skipping Claude Code CLI sync: claude not found");
+    }
+
+    // 2. 直接文件操作同步 ~/.claude.json（确保最终状态正确）
+    syncClaudeCodeConfigDirect(targetUrl, serverName);
+}
+
+/**
+ * 直接文件操作同步 ~/.claude.json（独立于 deps）
+ */
+function syncClaudeCodeConfigDirect(targetUrl, serverName) {
+    const configPath = getClaudeCodeConfigPath();
+    const sseUrl = `${targetUrl}/sse`;
+
+    let config = {};
+    if (fs.existsSync(configPath)) {
+        try {
+            config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+        } catch { /* 忽略 */ }
+    }
+
+    if (!config.mcpServers) config.mcpServers = {};
+
+    const current = config.mcpServers[serverName];
+    if (current && current.type === "sse" && current.url === sseUrl) {
+        console.log(`⏭️  Claude Code ~/.claude.json already up-to-date: ${sseUrl}`);
+        return;
+    }
+
+    config.mcpServers[serverName] = {
+        type: "sse",
+        url: sseUrl,
+    };
+
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log(`✓ Updated Claude Code ~/.claude.json: ${sseUrl}`);
+}
+
+// ==================== 导出 ====================
+
+export function setupClaudeCode(deps) {
+    createClaudeCodeUserConfig(deps);
+    copySkillToClaudeCode(deps, false);
+    copyAgentToClaudeCode(deps, false);
+    installClaudeCodeSlashCommand(deps);
+
+    let claudeProjectInstalled = false;
+    if (deps.PROJECT_ROOT && fs.existsSync(deps.PROJECT_ROOT)) {
+        try {
+            claudeProjectInstalled = createClaudeCodeProjectConfig(deps);
+            if (claudeProjectInstalled) {
+                copySkillToClaudeCode(deps, true);
+                copyAgentToClaudeCode(deps, true);
+            }
+        } catch (e) {
+            console.log(`⚠️  Failed to install Claude Code project config: ${e.message}`);
+        }
+    }
+
+    return {
+        claudeProjectInstalled,
+        skillsDirectory: getClaudeCodeSkillsDirectory(),
+        agentsDirectory: getClaudeCodeAgentsDirectory(),
+    };
+}

package/scripts/lib/common.js

@@ -0,0 +1,161 @@
+/**
+ * common.js — postinstall / update-mcp-url 共用的通用基础设施
+ *
+ * 导出常量、安全保护、文件操作、配置读取等工具函数。
+ * 递归守卫在模块加载时自动执行。
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import os from "node:os";
+import { execSync } from "node:child_process";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export const PACKAGE_ROOT = path.resolve(__dirname, "..", "..");
+export const SKILL_SOURCE = path.join(PACKAGE_ROOT, "standard-skill", "SKILL.md");
+
+// 项目根目录：从 PACKAGE_ROOT 向上推导
+export function findProjectRoot() {
+    let dir = PACKAGE_ROOT;
+    while (dir !== path.dirname(dir)) {
+        const parts = dir.split(path.sep);
+        const nodeModulesIndex = parts.lastIndexOf("node_modules");
+        if (nodeModulesIndex === -1) {
+            return dir;
+        }
+        dir = parts.slice(0, nodeModulesIndex).join(path.sep) || "/";
+    }
+    return dir;
+}
+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";
+if (process.env[RECURSION_GUARD_ENV]) {
+    console.log("⏭️  Skipping postinstall: detected recursive invocation (SZCD_POSTINSTALL_RUNNING is set)");
+    process.exit(0);
+}
+process.env[RECURSION_GUARD_ENV] = "1";
+
+const POSTINSTALL_TIMEOUT = 30000;
+const scriptStartTime = Date.now();
+export function checkGlobalTimeout() {
+    if (Date.now() - scriptStartTime > POSTINSTALL_TIMEOUT) {
+        console.warn("⚠️  Postinstall exceeded global timeout (30s), aborting remaining steps");
+        return false;
+    }
+    return true;
+}
+
+export function isCommandAvailable(cmd) {
+    try {
+        execSync(`which ${cmd} 2>/dev/null`, { stdio: "pipe", timeout: 500 });
+        return true;
+    } catch {
+        return false;
+    }
+}
+
+const CMD_TIMEOUT = 5000;
+export function safeExecSync(command, options = {}) {
+    if (!checkGlobalTimeout()) return false;
+    try {
+        execSync(command, { stdio: "pipe", timeout: CMD_TIMEOUT, ...options });
+        return true;
+    } catch (e) {
+        const stderr = e.stderr?.toString() || e.stdout?.toString() || "";
+        if (stderr.includes("already exists")) return "already_exists";
+        return false;
+    }
+}
+
+// ==================== 通用工具函数 ====================
+
+export function ensureDirectory(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        try {
+            fs.mkdirSync(dirPath, { recursive: true });
+            console.log(`✓ Created directory: ${dirPath}`);
+        } catch (error) {
+            console.error(`❌ Failed to create directory ${dirPath}: ${error.message}`);
+            throw error;
+        }
+    }
+}
+
+export function copyFile(source, destination) {
+    try {
+        if (!fs.existsSync(source)) {
+            throw new Error(`Source file not found: ${source}`);
+        }
+        fs.copyFileSync(source, destination);
+        console.log(`✓ Copied file: ${source} → ${destination}`);
+    } catch (error) {
+        console.error(`❌ Failed to copy file: ${error.message}`);
+        throw error;
+    }
+}
+
+export function writeFile(filePath, content) {
+    try {
+        fs.writeFileSync(filePath, content);
+        console.log(`✓ Created file: ${filePath}`);
+    } catch (error) {
+        console.error(`❌ Failed to write file ${filePath}: ${error.message}`);
+        throw error;
+    }
+}
+
+// ==================== 路径工具 ====================
+
+export function getHomeDir() {
+    if (os.platform() === "win32") {
+        return process.env.USERPROFILE || process.env.HOME || os.homedir();
+    }
+    return process.env.HOME || os.homedir();
+}
+
+export function getConfigFilePath() {
+    return path.join(getHomeDir(), ".szcd-mcp-config.json");
+}
+
+export function getProjectConfigFilePath() {
+    return path.join(PROJECT_ROOT, ".szcd-mcp-config.json");
+}
+
+// 优先级：项目级配置 > 用户级配置 > 默认值
+export function loadExistingConfig() {
+    const projectConfigPath = getProjectConfigFilePath();
+    try {
+        if (fs.existsSync(projectConfigPath)) {
+            return JSON.parse(fs.readFileSync(projectConfigPath, "utf8"));
+        }
+    } catch (error) { /* 忽略 */ }
+
+    const userConfigPath = getConfigFilePath();
+    try {
+        if (fs.existsSync(userConfigPath)) {
+            return JSON.parse(fs.readFileSync(userConfigPath, "utf8"));
+        }
+    } catch (error) { /* 忽略 */ }
+
+    return {};
+}
+
+export function getMcpServerUrl() {
+    const config = loadExistingConfig();
+    return config.MCP_SERVER_URL || DEFAULT_MCP_SERVER_URL;
+}
+
+export function getMcpServerName() {
+    const config = loadExistingConfig();
+    return config.MCP_SERVER_NAME || DEFAULT_MCP_SERVER_NAME;
+}

package/scripts/lib/opencode.js

@@ -0,0 +1,37 @@
+/**
+ * opencode.js — OpenCode 兼容逻辑
+ *
+ * 导出 setupOpenCode(deps) 供 postinstall.js 调用。
+ * deps 需包含: { getMcpServerUrl, PROJECT_ROOT, fs }
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+
+export function setupOpenCode(deps) {
+    const projectRoot = deps.PROJECT_ROOT;
+    const opencodeConfigPath = path.join(projectRoot, "opencode.json");
+
+    if (fs.existsSync(opencodeConfigPath)) {
+        console.log(`✓ opencode.json already exists: ${opencodeConfigPath}`);
+        return;
+    }
+
+    const opencodeConfig = {
+        $schema: "https://opencode.ai/config.json",
+        autoupdate: "notify",
+        instructions: ["请使用中文回复所有问题"],
+        mcp: {
+            "szcd-component-helper": {
+                type: "local",
+                command: ["npx", "szcd-mcp-proxy"],
+                environment: {
+                    MCP_SERVER_URL: deps.getMcpServerUrl(),
+                },
+            },
+        },
+    };
+
+    deps.writeFile(opencodeConfigPath, JSON.stringify(opencodeConfig, null, 2));
+    console.log(`✓ Created opencode.json: ${opencodeConfigPath}`);
+}