@szc-ft/mcp-szcd-client 0.11.0 → 0.11.2

package/AGENTS.md

@@ -0,0 +1,9 @@
+# 项目指令
+
+## 语言偏好
+
+始终使用中文（简体）回复用户，包括：
+- 所有对话回复
+- 代码注释说明
+- 错误信息和日志解读
+- 工具调用结果的解释说明

package/commands/szcd-mcp-coding-config.md

@@ -0,0 +1,42 @@
+---
+description: 管理CODING Issue工具的默认配置（baseUrl/projectId/account）
+argument-hint: <get|set|clear> [--baseUrl=xxx] [--projectId=yyy] [--account=zzz]
+---
+
+请帮我管理 szcd MCP 的 CODING 默认配置。
+
+**交互流程**：
+
+1. **向用户询问要执行的操作**，提供以下选项：
+   - "查看配置" → 执行 get
+   - "设置配置" → 执行 set（需进一步追问参数）
+   - "清除配置" → 执行 clear
+
+2. **根据用户选择执行**：
+
+   - **查看配置**：直接执行 `npx szcd-mcp-coding-config get`
+
+   - **设置配置**：逐项向用户询问以下参数，选项中提供当前值作为默认，用户也可自由输入新值：
+     - CODING_BASE_URL — CODING 基础地址，如 `http://e-kjr1wok.coding.smartcitysz.work`
+     - CODING_DEFAULT_PROJECT_ID — 默认项目 ID，如 `907`
+     - CODING_ACCOUNT — 默认账号（邮箱）
+     收集完参数后执行：
+     ```bash
+     npx szcd-mcp-coding-config set --baseUrl="<baseUrl>" --projectId="<projectId>" --account="<account>"
+     ```
+
+   - **清除配置**：确认后执行 `npx szcd-mcp-coding-config clear`
+
+3. **命令回退**：如果 npx 不可用，依次尝试：
+   - `node $(npm root -g)/@szc-ft/mcp-szcd-client/scripts/update-coding-config.js <args>`
+   - `node /scity/zengzhijie/szcd/mcp/szcd-mcp-client/scripts/update-coding-config.js <args>`
+
+**配置字段说明**：
+- `CODING_BASE_URL` — CODING 基础地址
+- `CODING_DEFAULT_PROJECT_ID` — 默认项目 ID
+- `CODING_ACCOUNT` — 默认账号（邮箱）
+
+配置保存在 `~/.szcd-mcp-config.json` 中，设置后 `coding_fetch_issue` 工具可省略 `baseUrl` 和 `projectId` 参数。
+
+当前配置:
+!`cat ~/.szcd-mcp-config.json 2>/dev/null | grep -E "CODING|MCP_SERVER" || echo "配置文件不存在或无 CODING 配置"`

package/commands/szcd-mcp-url.md

@@ -5,21 +5,33 @@ argument-hint: <new-mcp-server-url>
 
 请帮我更新 szcd MCP 服务器地址。
 
-**使用方式**：
-- 输入 URL 参数（如 `$1`）：用该 URL 更新配置文件并同步 IDE
-- 不输入 URL：用配置文件 `~/.szcd-mcp-config.json` 中已有的 MCP_SERVER_URL 同步 IDE 配置
+**交互流程**：
 
-执行以下命令：
+1. **向用户询问要执行的操作**，提供以下选项：
+   - "更新服务器地址" → 输入新 URL 并同步所有 IDE 配置
+   - "同步现有配置" → 用 `~/.szcd-mcp-config.json` 中已有的 MCP_SERVER_URL 重新同步 IDE 配置
+   - "查看当前配置" → 显示当前 MCP 服务器地址
 
-1. 运行更新脚本：
-   - 优先: `npx szcd-mcp-update-url "$1"`
-   - 若 npx 不可用: `node $(npm root -g)/@szc-ft/mcp-szcd-component-helper/scripts/update-mcp-url.js "$1"`
-   - 若全局安装也不可用: `node /scity/zengzhijie/szcd/mcp/szcd-component-helper/scripts/update-mcp-url.js "$1"`
+2. **根据用户选择执行**：
 
-2. 如果脚本执行失败，请手动执行以下步骤：
-   a. 编辑 `~/.szcd-mcp-config.json`，将 MCP_SERVER_URL 改为目标 URL
-   b. 如果 trae-cli 可用：`trae-cli mcp remove szcd-component-helper && trae-cli mcp add-json szcd-component-helper '{"type":"sse","url":"<目标URL>/sse"}'`
-   c. 如果 claude 可用：`claude mcp remove --scope user szcd-component-helper && claude mcp add --transport sse --scope user szcd-component-helper <目标URL>/sse`
+   - **更新服务器地址**：向用户询问新的 MCP 服务器 URL，可提供常用地址选项，用户也可自由输入。收集到 URL 后执行：
+     ```bash
+     npx szcd-mcp-update-url "<newUrl>"
+     ```
+
+   - **同步现有配置**：直接执行（不带参数）：
+     ```bash
+     npx szcd-mcp-update-url
+     ```
+
+   - **查看当前配置**：显示 `~/.szcd-mcp-config.json` 中的 MCP_SERVER_URL
+
+3. **命令回退**：如果 npx 不可用，依次尝试：
+   - `node $(npm root -g)/@szc-ft/mcp-szcd-client/scripts/update-mcp-url.js "<newUrl>"`
+   - `node /scity/zengzhijie/szcd/mcp/szcd-mcp-client/scripts/update-mcp-url.js "<newUrl>"`
+   - 手动步骤：编辑 `~/.szcd-mcp-config.json`，再逐个 IDE 同步：
+     - trae-cli: `trae-cli mcp remove szcd-component-helper && trae-cli mcp add-json szcd-component-helper '{"type":"sse","url":"<URL>/sse"}'`
+     - claude: `claude mcp remove --scope user szcd-component-helper && claude mcp add --transport sse --scope user szcd-component-helper <URL>/sse`
 
 当前配置:
 !`cat ~/.szcd-mcp-config.json 2>/dev/null || echo "配置文件不存在"`

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@szc-ft/mcp-szcd-client",
-    "version": "0.11.0",
+    "version": "0.11.2",
     "description": "MCP client for szcd component library - connects to remote MCP server via SSE or stdio proxy",
     "keywords": [
         "mcp",
@@ -21,17 +21,20 @@
     "bin": {
         "szcd-mcp-proxy": "mcp-proxy.js",
         "szcd-mcp-setup": "scripts/postinstall.js",
-        "szcd-mcp-update-url": "scripts/update-mcp-url.js"
+        "szcd-mcp-update-url": "scripts/update-mcp-url.js",
+        "szcd-mcp-coding-config": "scripts/update-coding-config.js"
     },
     "files": [
         "mcp-proxy.js",
         "scripts/postinstall.js",
         "scripts/update-mcp-url.js",
+        "scripts/update-coding-config.js",
         "scripts/lib/",
         "standard-skill/",
         "skill/",
         "agents/",
         "commands/",
+        "AGENTS.md",
         "README.md"
     ],
     "engines": {

package/scripts/lib/qoder.js

@@ -13,15 +13,16 @@
  *
  * Qoder 目录结构：
  *   ~/.qoder/
- *   ├── settings.json        # 权限/Hook/MCP 配置
- *   ├── agents/              # 子代理
+ *   ├── AGENTS.md          # 用户级项目指令（语言偏好等）
+ *   ├── settings.json      # 权限/Hook/MCP 配置
+ *   ├── agents/            # 子代理
  *   │   └── <agentName>.md
- *   ├── skills/              # Skills
+ *   ├── skills/            # Skills
  *   │   └── <skillName>/
  *   │       └── SKILL.md
- *   ├── commands/            # 自定义命令
+ *   ├── commands/          # 自定义命令
  *   │   └── <commandName>.md
- *   └── hooks/               # Hook 脚本
+ *   └── hooks/             # Hook 脚本
  */
 
 import fs from "node:fs";
@@ -64,6 +65,14 @@ function getQoderProjectSettingsPath(projectRoot) {
     return path.join(projectRoot, ".qoder", "settings.json");
 }
 
+function getQoderUserAgentsMdPath() {
+    return path.join(getQoderUserDirectory(), "AGENTS.md");
+}
+
+function getQoderProjectAgentsMdPath(projectRoot) {
+    return path.join(projectRoot, ".qoder", "AGENTS.md");
+}
+
 // ==================== JSON 读写 ====================
 
 function readJsonFile(filePath) {
@@ -274,6 +283,47 @@ function copyCommandsToQoder(deps, isProjectLevel = false) {
     return false;
 }
 
+// ==================== AGENTS.md 复制 ====================
+
+/**
+ * 复制 AGENTS.md 到用户级 ~/.qoder/AGENTS.md
+ * 如果已存在用户自定义内容则跳过（避免覆盖用户修改）
+ */
+function copyAgentsMdToQoder(deps, isProjectLevel = false) {
+    const agentsMdSource = path.join(deps.PACKAGE_ROOT, "AGENTS.md");
+    if (!fs.existsSync(agentsMdSource)) {
+        console.log("⏭️  Skipping AGENTS.md install: source file not found in package");
+        return false;
+    }
+
+    const agentsMdDest = isProjectLevel
+        ? getQoderProjectAgentsMdPath(deps.PROJECT_ROOT)
+        : getQoderUserAgentsMdPath();
+
+    try {
+        // 如果目标已存在，检查内容是否相同
+        if (fs.existsSync(agentsMdDest)) {
+            const existingContent = fs.readFileSync(agentsMdDest, "utf8").trim();
+            const sourceContent = fs.readFileSync(agentsMdSource, "utf8").trim();
+            if (existingContent === sourceContent) {
+                console.log(`✓ Qoder ${isProjectLevel ? "project" : "user"} AGENTS.md already up-to-date: ${agentsMdDest}`);
+                return true;
+            }
+            // 用户已自定义，不覆盖
+            console.log(`⏭️  Skipping Qoder AGENTS.md (${isProjectLevel ? "project" : "user"}): already exists with custom content`);
+            return false;
+        }
+
+        deps.ensureDirectory(path.dirname(agentsMdDest));
+        deps.copyFile(agentsMdSource, agentsMdDest);
+        console.log(`✓ Copied AGENTS.md to Qoder ${isProjectLevel ? "project" : "user"} directory: ${agentsMdDest}`);
+        return true;
+    } catch (error) {
+        console.log(`⚠️  Failed to copy AGENTS.md to Qoder ${isProjectLevel ? "project" : "user"} directory: ${error.message}`);
+        return false;
+    }
+}
+
 // ==================== 项目级配置 ====================
 
 function setupQoderProjectConfig(deps) {
@@ -401,6 +451,7 @@ export function setupQoder(deps) {
     copySkillToQoder(deps, false);
     copyAgentsToQoder(deps, false);
     copyCommandsToQoder(deps, false);
+    copyAgentsMdToQoder(deps, false);
 
     // ---- 项目级安装（暂不启用，用户级足够） ----
     // let qoderProjectInstalled = false;

package/scripts/update-coding-config.js

@@ -0,0 +1,246 @@
+#!/usr/bin/env node
+
+/**
+ * szcd-mcp-coding-config - 管理 CODING Issue 获取工具的默认配置
+ *
+ * 用法:
+ *   npx szcd-mcp-coding-config get                    查看当前 CODING 配置
+ *   npx szcd-mcp-coding-config set --baseUrl=xxx       设置 CODING 基础地址
+ *   npx szcd-mcp-coding-config set --projectId=xxx     设置默认项目 ID
+ *   npx szcd-mcp-coding-config set --account=xxx       设置默认账号
+ *   npx szcd-mcp-coding-config set --cookies=xxx       设置浏览器 Cookie
+ *   npx szcd-mcp-coding-config set --password=xxx      设置密码
+ *   npx szcd-mcp-coding-config set --baseUrl=xxx --projectId=yyy --cookies=zzz  批量设置
+ *   npx szcd-mcp-coding-config clear                   清除所有 CODING 配置
+ *
+ * 配置保存在 ~/.szcd-mcp-config.json 中，字段名：
+ *   CODING_BASE_URL              — CODING 基础地址
+ *   CODING_DEFAULT_PROJECT_ID    — 默认项目 ID
+ *   CODING_ACCOUNT               — 默认账号（邮箱）
+ *   CODING_COOKIES               — 浏览器 Cookie 字符串（敏感）
+ *   CODING_PASSWORD              — 密码（敏感）
+ */
+
+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, projectId: null, account: null, cookies: null, password: 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 === "projectId" || key === "project-id") args.projectId = value;
+                if (key === "account") args.account = value;
+                if (key === "cookies") args.cookies = value;
+                if (key === "password") args.password = value;
+            }
+        } else {
+            positional.push(arg);
+        }
+    }
+
+    args.action = positional[0] || "get";
+    return args;
+}
+
+// ==================== 命令实现 ====================
+
+function cmdGet() {
+    const config = loadConfig();
+
+    console.log(`\n📋 CODING 配置 (${getConfigFilePath()})\n`);
+    console.log(`  CODING_BASE_URL           : ${config.CODING_BASE_URL || "(未设置)"}`);
+    console.log(`  CODING_DEFAULT_PROJECT_ID : ${config.CODING_DEFAULT_PROJECT_ID || "(未设置)"}`);
+    console.log(`  CODING_ACCOUNT            : ${config.CODING_ACCOUNT || "(未设置)"}`);
+    console.log(`  CODING_COOKIES            : ${maskValue(config.CODING_COOKIES)}`);
+    console.log(`  CODING_PASSWORD           : ${maskValue(config.CODING_PASSWORD)}`);
+    console.log(`\n💡 配置后，coding_fetch_issue 工具可省略所有参数直接获取 Issue。`);
+    console.log(`   用法: npx szcd-mcp-coding-config set --baseUrl=xxx --projectId=yyy --cookies=xxx\n`);
+}
+
+function cmdSet(baseUrl, projectId, account, cookies, password) {
+    const config = loadConfig();
+    let changed = false;
+
+    if (baseUrl) {
+        const old = config.CODING_BASE_URL || "(未设置)";
+        config.CODING_BASE_URL = baseUrl;
+        console.log(`  CODING_BASE_URL           : ${old} → ${baseUrl}`);
+        changed = true;
+    }
+    if (projectId) {
+        const old = config.CODING_DEFAULT_PROJECT_ID || "(未设置)";
+        config.CODING_DEFAULT_PROJECT_ID = projectId;
+        console.log(`  CODING_DEFAULT_PROJECT_ID : ${old} → ${projectId}`);
+        changed = true;
+    }
+    if (account) {
+        const old = config.CODING_ACCOUNT || "(未设置)";
+        config.CODING_ACCOUNT = account;
+        console.log(`  CODING_ACCOUNT            : ${old} → ${account}`);
+        changed = true;
+    }
+    if (cookies) {
+        const old = maskValue(config.CODING_COOKIES);
+        config.CODING_COOKIES = cookies;
+        console.log(`  CODING_COOKIES            : ${old} → ${maskValue(cookies)}`);
+        changed = true;
+    }
+    if (password) {
+        const old = maskValue(config.CODING_PASSWORD);
+        config.CODING_PASSWORD = password;
+        console.log(`  CODING_PASSWORD           : ${old} → ${maskValue(password)}`);
+        changed = true;
+    }
+
+    if (!changed) {
+        console.log("\n⚠️  未提供任何要设置的参数。用法:");
+        console.log("   npx szcd-mcp-coding-config set --baseUrl=xxx --projectId=yyy --account=zzz --cookies=xxx --password=yyy\n");
+        return false;
+    }
+
+    if (saveConfig(config)) {
+        console.log(`\n✅ 配置已保存。`);
+        console.log(`   CODING_BASE_URL           : ${config.CODING_BASE_URL || "(未设置)"}`);
+        console.log(`   CODING_DEFAULT_PROJECT_ID : ${config.CODING_DEFAULT_PROJECT_ID || "(未设置)"}`);
+        console.log(`   CODING_ACCOUNT            : ${config.CODING_ACCOUNT || "(未设置)"}`);
+        console.log(`   CODING_COOKIES            : ${maskValue(config.CODING_COOKIES)}`);
+        console.log(`   CODING_PASSWORD           : ${maskValue(config.CODING_PASSWORD)}\n`);
+        return true;
+    }
+    console.log("\n❌ 保存配置失败。\n");
+    return false;
+}
+
+function cmdClear() {
+    const config = loadConfig();
+    const hadBaseUrl = !!config.CODING_BASE_URL;
+    const hadProjectId = !!config.CODING_DEFAULT_PROJECT_ID;
+    const hadAccount = !!config.CODING_ACCOUNT;
+    const hadCookies = !!config.CODING_COOKIES;
+    const hadPassword = !!config.CODING_PASSWORD;
+
+    if (!hadBaseUrl && !hadProjectId && !hadAccount && !hadCookies && !hadPassword) {
+        console.log("\n⏭️  没有 CODING 配置需要清除。\n");
+        return false;
+    }
+
+    delete config.CODING_BASE_URL;
+    delete config.CODING_DEFAULT_PROJECT_ID;
+    delete config.CODING_ACCOUNT;
+    delete config.CODING_COOKIES;
+    delete config.CODING_PASSWORD;
+
+    if (saveConfig(config)) {
+        console.log("\n✅ 已清除 CODING 配置。\n");
+        return true;
+    }
+    console.log("\n❌ 清除配置失败。\n");
+    return false;
+}
+
+// ==================== 帮助信息 ====================
+
+function printHelp() {
+    console.log(`
+Usage: npx szcd-mcp-coding-config <command> [options]
+
+Commands:
+  get                          查看当前 CODING 配置
+  set [options]                设置 CODING 配置项
+  clear                        清除所有 CODING 配置
+
+Options for 'set':
+  --baseUrl=<url>              CODING 基础地址，如 http://e-kjr1wok.coding.smartcitysz.work
+  --projectId=<id>             默认项目 ID，如 907
+  --account=<email>            默认账号（邮箱）
+  --cookies=<string>           浏览器 Cookie 字符串（敏感）
+  --password=<string>          CODING 密码（敏感）
+
+Examples:
+  npx szcd-mcp-coding-config get
+  npx szcd-mcp-coding-config set --baseUrl=http://e-kjr1wok.coding.smartcitysz.work --projectId=907
+  npx szcd-mcp-coding-config set --cookies="enterprise_domain=xxx; cf=xxx; XSRF-TOKEN=xxx"
+  npx szcd-mcp-coding-config set --baseUrl=xxx --projectId=yyy --cookies=zzz --password=www
+  npx szcd-mcp-coding-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.projectId, args.account, args.cookies, args.password);
+        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();