@wuyax/mcps 0.1.0-beta.3 → 0.1.0

package/dist/cli.js

@@ -1,24 +1,28 @@
 import {
-  getMcpAgentTypes,
-  installMcpServer,
-  listInstalledMcpServers,
+  displayServerDetails,
   logCoHostedNotice,
   logger,
   mainMenu,
-  mcpManageCommand,
-  parseKeyValueList,
+  wizardAdd,
+  wizardManage,
+  wizardRemove
+} from "./chunk-AWD3VQ3S.js";
+import {
+  applyServerConfigDelta,
+  getMcpAgentTypes,
+  installMcpServer,
+  listInstalledMcpServers,
   parseMcpAgentList,
   parseMcpSource,
+  queryGroupedInstalledServers,
   removeMcpServer,
   resolveTargetAgents,
-  resolveTransport,
   toErrorMessage,
-  wizardAdd,
-  wizardRemove
-} from "./chunk-BUKA3NPJ.js";
+  updateMcpServer
+} from "./chunk-O3BRJFEC.js";
 
 // src/cli.ts
-import { Command as Command4 } from "commander";
+import { Command as Command5 } from "commander";
 
 // src/cli/add.ts
 import { Command } from "commander";
@@ -27,6 +31,30 @@ import pc from "picocolors";
 // src/utils/format-agent-list.ts
 var formatAgentList = (agentList, emptyLabel = "(none)") => agentList.length === 0 ? emptyLabel : agentList.join(", ");
 
+// src/utils/parse-key-value-list.ts
+var parseKeyValueList = (entries, separator) => {
+  if (!entries || entries.length === 0) return {};
+  const result = {};
+  for (const entry of entries) {
+    const splitIndex = entry.indexOf(separator);
+    if (splitIndex === -1) {
+      throw new Error(`Invalid entry "${entry}": expected "${separator}" separator`);
+    }
+    const key = entry.slice(0, splitIndex).trim();
+    const value = entry.slice(splitIndex + separator.length).trim();
+    if (!key) throw new Error(`Invalid entry "${entry}": empty key`);
+    result[key] = value;
+  }
+  return result;
+};
+
+// src/utils/resolve-transport.ts
+var resolveTransport = (input) => {
+  if (!input) return void 0;
+  if (input === "http" || input === "sse") return input;
+  throw new Error(`Unsupported transport "${input}" (expected: http, sse)`);
+};
+
 // src/cli/add.ts
 var mcpAddCommand = new Command("add").description("Add an MCP server to coding agents").argument("[source]", "Remote URL, npm package, or command line").option("-a, --agent <agents...>", "Target specific agents (use '*' for all)").option("-g, --global", "Install to user-level config instead of project").option("-t, --transport <type>", "Transport type for remote servers (http or sse)").option("--header <header...>", "HTTP header (Key: Value), repeatable").option("--env <env...>", "Env var for stdio servers (KEY=VALUE), repeatable").option("--args <args...>", "CLI arguments for stdio/package servers").option("-n, --name <name>", "Server name override").option("-y, --yes", "Skip all prompts").option("--all", "Install to all supported agents").action(async (source, options) => {
   try {
@@ -144,10 +172,153 @@ var mcpListCommand = new Command2("list").alias("ls").description("List installe
   }
 });
 
-// src/cli/remove.ts
+// src/cli/manage.ts
 import { Command as Command3 } from "commander";
 import pc3 from "picocolors";
-var mcpRemoveCommand = new Command3("remove").alias("rm").description("Remove an MCP server from agent configs").argument("[name]", "Server name").option("-g, --global", "Remove from global scope").option("-a, --agent <agents...>", "Filter by specific agents (use '*' for all)").option("-y, --yes", "Skip confirmation prompts").action(async (name, options) => {
+var requireTargetServerGroup = (serverName, scope) => {
+  const grouped = queryGroupedInstalledServers(scope);
+  const targetGroup = grouped.get(serverName);
+  if (!targetGroup) {
+    logger.error(
+      `MCP server "${serverName}" is not configured in ${scope.global ? "global" : "project"} scope.`
+    );
+    process.exitCode = 1;
+    return void 0;
+  }
+  return targetGroup;
+};
+var mcpManageCommand = new Command3("manage").description("Inspect, modify, and sync installed MCP servers across coding agents").argument("[server-name]", "Optional server name to inspect or manage").option("-a, --agent <agents...>", "Target specific agents for update").option("-g, --global", "Manage global scope servers instead of project").option("-t, --transport <type>", "Transport type for remote servers (http or sse)").option("--header <header...>", "HTTP header (Header: Value), repeatable").option("--clear-headers", "Clear all HTTP headers for remote servers").option("--env <env...>", "Env var for stdio servers (KEY=VALUE), repeatable").option("--clear-env", "Clear all environment variables for stdio servers").option("--args <args...>", "CLI arguments for stdio/package servers").option("--clear-args", "Clear all arguments for stdio/package servers").option("--command <command>", "Executable command for stdio servers").option("--url <url>", "Remote endpoint URL").option("-y, --yes", "Skip interactive prompts").action(async (serverName, options) => {
+  try {
+    const cwd = process.cwd();
+    const isGlobal = Boolean(options.global);
+    const hasModifications = options.command !== void 0 || options.args !== void 0 || Boolean(options.clearArgs) || options.env !== void 0 || Boolean(options.clearEnv) || options.header !== void 0 || Boolean(options.clearHeaders) || options.url !== void 0 || options.transport !== void 0;
+    const isInteractive = Boolean(process.stdin.isTTY && !options.yes);
+    if (hasModifications) {
+      if (!serverName) {
+        logger.error('Missing required argument: "server-name" when passing modification flags.');
+        process.exitCode = 1;
+        return;
+      }
+      const targetGroup = requireTargetServerGroup(serverName, { global: isGlobal, cwd });
+      if (!targetGroup) {
+        return;
+      }
+      const parsedEnv = options.env !== void 0 ? parseKeyValueList(options.env, "=") : void 0;
+      const parsedHeaders = options.header !== void 0 ? parseKeyValueList(options.header, ":") : void 0;
+      let deltaResult;
+      try {
+        deltaResult = applyServerConfigDelta(targetGroup.config, {
+          command: options.command,
+          args: options.args,
+          clearArgs: options.clearArgs,
+          env: parsedEnv,
+          clearEnv: options.clearEnv,
+          url: options.url,
+          transport: resolveTransport(options.transport),
+          headers: parsedHeaders,
+          clearHeaders: options.clearHeaders
+        });
+      } catch (error) {
+        logger.error(toErrorMessage(error));
+        process.exitCode = 1;
+        return;
+      }
+      if (deltaResult.ignoredFlags.length > 0) {
+        const isRemote = deltaResult.protocol === "remote";
+        const hint = isRemote ? options.url !== void 0 ? "When configuring a remote server, stdio flags are ignored." : "Use --command to switch to stdio mode." : options.command !== void 0 ? "When configuring a stdio server, remote flags are ignored." : "Use --url to switch to remote mode.";
+        logger.warn(
+          `Server "${serverName}" is a ${isRemote ? "remote" : "stdio"} server. The following ${isRemote ? "stdio" : "remote"} flags will be ignored: ${deltaResult.ignoredFlags.join(", ")}. ${hint}`
+        );
+      }
+      const incomingDelta = deltaResult.config;
+      let targetAgents = targetGroup.agents;
+      if (options.agent !== void 0) {
+        const parsed = parseMcpAgentList(options.agent);
+        if (!parsed || parsed.length === 0) {
+          logger.error(`No valid agents recognized from: "${options.agent.join(", ")}".`);
+          process.exitCode = 1;
+          return;
+        }
+        targetAgents = parsed;
+      }
+      const updateResult = updateMcpServer({
+        serverName,
+        config: incomingDelta,
+        previousConfig: targetGroup.config,
+        agents: targetAgents,
+        global: isGlobal,
+        cwd
+      });
+      for (const item of updateResult.incompatible) {
+        logger.warn(`Skipping ${pc3.cyan(item.agent)}: ${item.reason}`);
+      }
+      const attemptedResults = updateResult.results.filter(
+        (r) => !updateResult.incompatible.some((i) => i.agent === r.agent)
+      );
+      if (attemptedResults.length === 0) {
+        const requestedTransport = updateResult.config.url ? updateResult.config.type ?? "http" : "stdio";
+        logger.error(
+          `None of the target agents support ${requestedTransport} transport. Update aborted.`
+        );
+        process.exitCode = 1;
+        return;
+      }
+      logger.info(
+        `Updating ${pc3.bold(serverName)} across ${pc3.cyan(String(attemptedResults.length))} agent(s)...`
+      );
+      let allSuccess = true;
+      for (const res of attemptedResults) {
+        if (res.success) {
+          logger.success(`${pc3.cyan(res.agent)}: Successfully updated in ${pc3.dim(res.path)}`);
+          logCoHostedNotice("configured", res.coConfiguredAgents);
+        } else {
+          allSuccess = false;
+          logger.error(`${pc3.cyan(res.agent)}: Update failed - ${res.error}`);
+        }
+      }
+      if (!allSuccess) {
+        process.exitCode = 1;
+      }
+      return;
+    }
+    if (!isInteractive) {
+      if (!serverName) {
+        logger.error(
+          'Missing required argument: "server-name" for non-interactive manage command. Specify a server name or use interactive terminal.'
+        );
+        process.exitCode = 1;
+        return;
+      }
+      const targetGroup = requireTargetServerGroup(serverName, { global: isGlobal, cwd });
+      if (!targetGroup) {
+        return;
+      }
+      displayServerDetails({
+        serverName,
+        config: targetGroup.config,
+        agents: targetGroup.agents,
+        global: isGlobal,
+        hasDivergence: targetGroup.hasDivergence
+      });
+      return;
+    }
+    await wizardManage({
+      global: options.global,
+      serverName
+    });
+  } catch (error) {
+    if (error && typeof error === "object" && "name" in error && error.name === "ExitPromptError") {
+      process.exit(0);
+    }
+    logger.error(toErrorMessage(error));
+    process.exitCode = 1;
+  }
+});
+
+// src/cli/remove.ts
+import { Command as Command4 } from "commander";
+import pc4 from "picocolors";
+var mcpRemoveCommand = new Command4("remove").alias("rm").description("Remove an MCP server from agent configs").argument("[name]", "Server name").option("-g, --global", "Remove from global scope").option("-a, --agent <agents...>", "Filter by specific agents (use '*' for all)").option("-y, --yes", "Skip confirmation prompts").action(async (name, options) => {
   try {
     const isInteractive = Boolean(process.stdin.isTTY && !options.yes);
     if (!name) {
@@ -170,17 +341,17 @@ var mcpRemoveCommand = new Command3("remove").alias("rm").description("Remove an
       cwd: process.cwd()
     });
     if (results.length === 0) {
-      logger.warn(`No agent config contained ${pc3.bold(name)}`);
+      logger.warn(`No agent config contained ${pc4.bold(name)}`);
       return;
     }
     for (const record of results) {
       if (record.removed) {
         logger.success(
-          `${pc3.cyan(record.agent)} removed ${pc3.bold(name)} ${pc3.dim(record.path)}`
+          `${pc4.cyan(record.agent)} removed ${pc4.bold(name)} ${pc4.dim(record.path)}`
         );
         logCoHostedNotice("affected", record.coAffectedAgents);
       } else {
-        logger.error(`${pc3.cyan(record.agent)}: ${record.error ?? "not found"}`);
+        logger.error(`${pc4.cyan(record.agent)}: ${record.error ?? "not found"}`);
       }
     }
   } catch (error) {
@@ -190,10 +361,10 @@ var mcpRemoveCommand = new Command3("remove").alias("rm").description("Remove an
 });
 
 // src/cli.ts
-var VERSION = "0.1.0-beta.3";
+var VERSION = "0.1.0";
 process.on("SIGINT", () => process.exit(0));
 process.on("SIGTERM", () => process.exit(0));
-var program = new Command4().name("mcps").description("Install, list, and remove MCP servers across AI coding agents").version(VERSION, "-v, --version", "display the version number");
+var program = new Command5().name("mcps").description("Install, list, and remove MCP servers across AI coding agents").version(VERSION, "-v, --version", "display the version number");
 program.addCommand(mcpAddCommand);
 program.addCommand(mcpListCommand);
 program.addCommand(mcpManageCommand);