@wuyax/mcps 0.1.0-beta.1

package/dist/cli.d.cts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/cli.js

@@ -0,0 +1,228 @@
+import {
+  getMcpAgentTypes,
+  installMcpServer,
+  listInstalledMcpServers,
+  logger,
+  mainMenu,
+  parseMcpAgentList,
+  parseMcpSource,
+  removeMcpServer,
+  resolveTargetAgents,
+  toErrorMessage,
+  wizardAdd,
+  wizardRemove
+} from "./chunk-XW2KL6W3.js";
+
+// src/cli.ts
+import { Command as Command4 } from "commander";
+
+// src/cli/add.ts
+import { Command } from "commander";
+import pc from "picocolors";
+
+// src/utils/format-agent-list.ts
+var formatAgentList = (agentList, emptyLabel = "(none)") => agentList.length === 0 ? emptyLabel : agentList.join(", ");
+
+// src/cli/add.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;
+};
+var resolveTransport = (input) => {
+  if (!input) return void 0;
+  if (input === "http" || input === "sse") return input;
+  throw new Error(`Unsupported transport "${input}" (expected: http, sse)`);
+};
+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 {
+    const isInteractive = Boolean(process.stdin.isTTY && !options.yes);
+    if (!source) {
+      if (isInteractive) {
+        const success = await wizardAdd({
+          name: options.name,
+          global: options.global,
+          args: options.args,
+          transport: resolveTransport(options.transport),
+          headers: parseKeyValueList(options.header, ":"),
+          env: parseKeyValueList(options.env, "="),
+          agents: options.all ? getMcpAgentTypes() : parseMcpAgentList(options.agent)
+        });
+        if (!success) process.exitCode = 1;
+        return;
+      }
+      logger.error('Missing required argument: "source" (e.g. mcps add @modelcontextprotocol/server-filesystem)');
+      process.exitCode = 1;
+      return;
+    }
+    const parsed = parseMcpSource(source);
+    const cwd = process.cwd();
+    const isGlobal = Boolean(options.global);
+    const explicitTransport = resolveTransport(options.transport);
+    const transport = explicitTransport ?? (parsed.type === "remote" ? "http" : "stdio");
+    const resolvedTargets = resolveTargetAgents({
+      requested: options.agent,
+      all: options.all,
+      global: isGlobal,
+      cwd,
+      transport
+    });
+    if (resolvedTargets.agents.length === 0) {
+      const message = resolvedTargets.diagnostic ?? `No ${isGlobal ? "global" : "project"}-installed MCP agents detected. Pass ${pc.cyan("-a <agent>")} (e.g. ${pc.cyan("-a cursor")}) or ${pc.cyan("--all")} to install.`;
+      logger.warn(message);
+      process.exitCode = 1;
+      return;
+    }
+    if (resolvedTargets.isDetected) {
+      logger.info(
+        `Detected ${isGlobal ? "global" : "project"} agents: ${pc.cyan(formatAgentList(resolvedTargets.detected, "(none detected)"))}`
+      );
+      if (resolvedTargets.incompatible.length > 0) {
+        const skippedList = resolvedTargets.incompatible.map((item) => `${item.agent} (${item.reason})`).join(", ");
+        logger.info(
+          `Skipping detected agents incompatible with ${transport}: ${pc.yellow(skippedList)}`
+        );
+      }
+    }
+    const targetAgents = resolvedTargets.isDetected ? resolvedTargets.agents : resolvedTargets.allAgents;
+    const result = installMcpServer({
+      source,
+      name: options.name,
+      agents: targetAgents,
+      args: options.args,
+      global: isGlobal,
+      cwd,
+      transport: explicitTransport,
+      headers: parseKeyValueList(options.header, ":"),
+      env: parseKeyValueList(options.env, "=")
+    });
+    logger.info(
+      `Installing ${pc.bold(result.serverName)} (${pc.cyan(parsed.type)}) to ${pc.cyan(String(result.results.length))} agent(s)`
+    );
+    for (const record of result.results) {
+      if (record.success) {
+        logger.success(`${pc.cyan(record.agent)} ${pc.dim(record.path)}`);
+      } else {
+        logger.error(`${pc.cyan(record.agent)}: ${record.error}`);
+      }
+    }
+    if (result.results.some((record) => !record.success)) process.exitCode = 1;
+  } catch (error) {
+    logger.error(toErrorMessage(error));
+    process.exitCode = 1;
+  }
+});
+
+// src/cli/list.ts
+import { Command as Command2 } from "commander";
+import pc2 from "picocolors";
+var mcpListCommand = new Command2("list").alias("ls").description("List installed MCP servers across agents").option("-g, --global", "List global configs instead of project").option("-a, --agent <agents...>", "Filter by specific agents").option("--json", "Output as JSON").action((options) => {
+  try {
+    const entries = listInstalledMcpServers({
+      global: Boolean(options.global),
+      cwd: process.cwd(),
+      agents: parseMcpAgentList(options.agent)
+    });
+    if (options.json) {
+      console.log(JSON.stringify(entries, null, 2));
+      return;
+    }
+    if (entries.length === 0) {
+      logger.warn("No MCP servers installed");
+      return;
+    }
+    const grouped = /* @__PURE__ */ new Map();
+    for (const entry of entries) {
+      const existing = grouped.get(entry.serverName) ?? [];
+      existing.push(entry);
+      grouped.set(entry.serverName, existing);
+    }
+    for (const [serverName, group] of grouped) {
+      const agentLabels = group.map((record) => record.agent).join(", ");
+      console.log(`  ${pc2.bold(serverName)} ${pc2.dim(`[${agentLabels}]`)}`);
+      const firstPath = group[0]?.path;
+      if (firstPath) console.log(`    ${pc2.dim(firstPath)}`);
+    }
+  } catch (error) {
+    logger.error(toErrorMessage(error));
+    process.exitCode = 1;
+  }
+});
+
+// src/cli/remove.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) => {
+  try {
+    const isInteractive = Boolean(process.stdin.isTTY && !options.yes);
+    if (!name) {
+      if (isInteractive) {
+        const success = await wizardRemove({
+          global: options.global,
+          agents: parseMcpAgentList(options.agent)
+        });
+        if (!success) process.exitCode = 1;
+        return;
+      }
+      logger.error('Missing required argument: "name" (e.g. mcps remove server-filesystem)');
+      process.exitCode = 1;
+      return;
+    }
+    const results = removeMcpServer({
+      name,
+      agents: parseMcpAgentList(options.agent),
+      global: Boolean(options.global),
+      cwd: process.cwd()
+    });
+    if (results.length === 0) {
+      logger.warn(`No agent config contained ${pc3.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)}`
+        );
+      } else {
+        logger.error(`${pc3.cyan(record.agent)}: ${record.error ?? "not found"}`);
+      }
+    }
+  } catch (error) {
+    logger.error(toErrorMessage(error));
+    process.exitCode = 1;
+  }
+});
+
+// src/cli.ts
+var VERSION = "0.1.0-beta.1";
+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");
+program.addCommand(mcpAddCommand);
+program.addCommand(mcpListCommand);
+program.addCommand(mcpRemoveCommand);
+var main = async () => {
+  if (process.argv.length <= 2 && process.stdin.isTTY) {
+    try {
+      await mainMenu();
+      return;
+    } catch (error) {
+      if (error?.name === "ExitPromptError") {
+        process.exit(0);
+      }
+      throw error;
+    }
+  }
+  await program.parseAsync();
+};
+main();