@wuyax/mcps 0.1.0-beta.1 → 0.1.0-beta.2

package/dist/index.d.cts

@@ -1,3 +1,5 @@
+import { Command } from 'commander';
+
 type McpAgentType = "amp" | "antigravity" | "antigravity-cli" | "augment" | "cline" | "cline-cli" | "claude-code" | "claude-desktop" | "codex" | "cursor" | "gemini-cli" | "grok" | "goose" | "github-copilot-cli" | "kimi-code-cli" | "kiro" | "opencode" | "pi" | "qoder" | "qwen-code" | "trae" | "vscode" | "zed";
 type McpConfigFormat = "json" | "jsonc" | "yaml" | "toml";
 type McpTransportType = "http" | "sse" | "stdio";
@@ -272,7 +274,19 @@ interface WizardAddOptions extends McpScopeOptions {
 }
 declare const wizardAdd: (initial?: WizardAddOptions) => Promise<boolean>;
 
-type WizardManageOptions = McpScopeOptions;
+interface WizardManageOptions extends McpScopeOptions {
+    serverName?: string;
+}
+/**
+ * Reusable display function for server details with secret masking.
+ */
+declare const displayServerDetails: ({ serverName, config, agents, isGlobal, titlePrefix, }: {
+    serverName: string;
+    config: McpServerConfig;
+    agents?: McpAgentType[];
+    isGlobal?: boolean;
+    titlePrefix?: string;
+}) => void;
 declare const wizardManage: (options?: WizardManageOptions) => Promise<void>;
 
 interface WizardRemoveOptions extends McpScopeOptions {
@@ -281,6 +295,39 @@ interface WizardRemoveOptions extends McpScopeOptions {
 }
 declare const wizardRemove: (options?: WizardRemoveOptions) => Promise<boolean>;
 
+interface PromptEditKeyValueOptions {
+    title: string;
+    itemNoun: string;
+    itemsNoun: string;
+    maskValue: (key: string, value: string) => string;
+    isSecretKey: (key: string) => boolean;
+    formatText: (items: Record<string, string>) => string;
+    parseText: (text: string) => Record<string, string>;
+    editorPostfix?: string;
+    editorMessage: string;
+    pasteMessage: string;
+    keyPromptMessage: string;
+    valuePromptMessage: string;
+    separator: "=" | ":";
+}
+/**
+ * Generic reusable interactive key-value editing loop supporting:
+ * - Editor launch with pre-filled content ($EDITOR)
+ * - Single item upsert (with secret detection & password masking)
+ * - Single item deletion
+ * - Multiline paste (with merge or replace choices)
+ * - Clear all items
+ */
+declare const promptEditKeyValueConfig: (currentItems: Record<string, string> | undefined, options: PromptEditKeyValueOptions) => Promise<Record<string, string>>;
+
+/**
+ * Masks sensitive values for secure CLI display.
+ */
+declare const maskSecretValue: (key: string, value: string) => string;
+/**
+ * Formats a key-value env record into .env formatted multiline string.
+ */
+declare const formatEnvText: (env: Record<string, string>) => string;
 /**
  * Parses multiline .env formatted text into a key-value record.
  * Supports:
@@ -298,7 +345,20 @@ declare const parseEnvText: (rawText: string) => Record<string, string>;
  * 3. Add key-value one by one (with secret mask detection)
  */
 declare const promptEnvConfig: (initialEnv?: Record<string, string>) => Promise<Record<string, string>>;
+/**
+ * Dedicated prompt loop for inspecting, modifying, adding, and removing
+ * environment variables of an existing MCP server configuration.
+ */
+declare const promptEditEnvConfig: (currentEnv?: Record<string, string>) => Promise<Record<string, string>>;
 
+/**
+ * Masks sensitive HTTP header values for secure CLI display.
+ */
+declare const maskSecretHeader: (key: string, value: string) => string;
+/**
+ * Formats a key-value headers record into multiline Key: Value text.
+ */
+declare const formatHeadersText: (headers: Record<string, string>) => string;
 /**
  * Parses multiline HTTP headers text (Key: Value or Key=Value) into a Record<string, string>.
  */
@@ -307,6 +367,11 @@ declare const parseHeadersText: (rawText: string) => Record<string, string>;
  * Interactively prompts user for HTTP headers.
  */
 declare const promptHeadersConfig: (initialHeaders?: Record<string, string>) => Promise<Record<string, string>>;
+/**
+ * Dedicated prompt loop for inspecting, modifying, adding, and removing
+ * HTTP headers of an existing MCP server configuration.
+ */
+declare const promptEditHeadersConfig: (currentHeaders?: Record<string, string>) => Promise<Record<string, string>>;
 
 /**
  * Parses a command-line argument string into an array of arguments,
@@ -317,6 +382,15 @@ declare const parseArgsString: (rawText: string) => string[];
  * Prompts the user for additional command-line arguments.
  */
 declare const promptArgsConfig: (initialArgs?: string[]) => Promise<string[]>;
+/**
+ * Formats an array of argument strings into a space-separated CLI string,
+ * quoting arguments containing spaces or quotes.
+ */
+declare const formatArgsString: (args: string[]) => string;
+/**
+ * Dedicated prompt for editing command arguments with current arguments pre-filled.
+ */
+declare const promptEditArgs: (currentArgs?: string[]) => Promise<string[]>;
 
 interface PromptScopeAndAgentsOptions extends McpScopeOptions {
     defaultGlobal?: boolean;
@@ -342,6 +416,8 @@ interface PromptScopeOptions extends McpScopeOptions {
  */
 declare const promptScope: (options?: PromptScopeOptions) => Promise<boolean>;
 
+declare const mcpManageCommand: Command;
+
 interface GroupedInstalledServer {
     serverName: string;
     agents: McpAgentType[];
@@ -375,4 +451,4 @@ declare const transformServerConfigForAgent: (agent: McpAgentConfig, serverName:
     global: boolean;
 }) => unknown;
 
-export { AgentConfigStore, type AgentConfigStoreListResult, type AgentConfigStoreRemoveResult, type AgentConfigStoreWriteResult, type ConfigStoreAdapter, type ConfigTargetDescriptor, DEFAULT_REMOTE_TRANSPORT, type GroupedInstalledServer, type IncompatibleAgent, type InstallMcpServerOptions, type InstallMcpServerResult, type ListedMcpServer, type McpAgentConfig, type McpAgentType, type McpConfigFormat, type McpInstallResultForAgent, type McpRemoteServerConfig, type McpRemoteTransport, type McpScopeOptions, type McpServerConfig, type McpSourceType, type McpStdioServerConfig, type McpTransportType, NPX_COMMAND, NPX_DASH_Y, type ParsedMcpSource, type RemoveMcpServerOptions, type RemoveMcpServerResult, type ServerConfigDialect, type ServerConfigDialectName, type ServerConfigDialectOptions, type TargetResolutionQuery, type TargetResolutionResult, installMcpServer as add, agentConfigStore, buildMcpServerConfig, createAgentTransform, detectGloballyInstalledMcpAgents, detectProjectInstalledMcpAgents, extractPackageName, getMcpAgentConfig, getMcpAgentTypes, getMcpAgentsSupportingProjectScope, groupInstalledServersByName, installMcpServer as install, installMcpServer, installMcpServerForAgent, installMcpServerForAgents, isMcpAgentType, isMcpTransportSupported, isRemoteMcpSource, isRemoteServerConfig, isStdioServerConfig, listInstalledMcpServers as list, listInstalledMcpServers, listServersInConfigFile, mainMenu, mcpAgentAliases, mcpAgents, normalizeServerConfig, parseArgsString, parseEnvText, parseHeadersText, parseMcpSource, parseServerConfig, parseMcpSource as parseSource, promptArgsConfig, promptEnvConfig, promptHeadersConfig, promptScope, promptScopeAndAgents, readConfigFile, removeMcpServer as remove, removeMcpServer, removeMcpServerFromAgent, removeServerFromConfigFile, resolveMcpAgentAlias, resolveMcpConfigTarget, resolveTargetAgents, transformServerConfig, transformServerConfigForAgent, wizardAdd, wizardManage, wizardRemove, writeServerToConfigFile };
+export { AgentConfigStore, type AgentConfigStoreListResult, type AgentConfigStoreRemoveResult, type AgentConfigStoreWriteResult, type ConfigStoreAdapter, type ConfigTargetDescriptor, DEFAULT_REMOTE_TRANSPORT, type GroupedInstalledServer, type IncompatibleAgent, type InstallMcpServerOptions, type InstallMcpServerResult, type ListedMcpServer, type McpAgentConfig, type McpAgentType, type McpConfigFormat, type McpInstallResultForAgent, type McpRemoteServerConfig, type McpRemoteTransport, type McpScopeOptions, type McpServerConfig, type McpSourceType, type McpStdioServerConfig, type McpTransportType, NPX_COMMAND, NPX_DASH_Y, type ParsedMcpSource, type PromptEditKeyValueOptions, type RemoveMcpServerOptions, type RemoveMcpServerResult, type ServerConfigDialect, type ServerConfigDialectName, type ServerConfigDialectOptions, type TargetResolutionQuery, type TargetResolutionResult, type WizardManageOptions, installMcpServer as add, agentConfigStore, buildMcpServerConfig, createAgentTransform, detectGloballyInstalledMcpAgents, detectProjectInstalledMcpAgents, displayServerDetails, extractPackageName, formatArgsString, formatEnvText, formatHeadersText, getMcpAgentConfig, getMcpAgentTypes, getMcpAgentsSupportingProjectScope, groupInstalledServersByName, installMcpServer as install, installMcpServer, installMcpServerForAgent, installMcpServerForAgents, isMcpAgentType, isMcpTransportSupported, isRemoteMcpSource, isRemoteServerConfig, isStdioServerConfig, listInstalledMcpServers as list, listInstalledMcpServers, listServersInConfigFile, mainMenu, maskSecretHeader, maskSecretValue, mcpAgentAliases, mcpAgents, mcpManageCommand, normalizeServerConfig, parseArgsString, parseEnvText, parseHeadersText, parseMcpSource, parseServerConfig, parseMcpSource as parseSource, promptArgsConfig, promptEditArgs, promptEditEnvConfig, promptEditHeadersConfig, promptEditKeyValueConfig, promptEnvConfig, promptHeadersConfig, promptScope, promptScopeAndAgents, readConfigFile, removeMcpServer as remove, removeMcpServer, removeMcpServerFromAgent, removeServerFromConfigFile, resolveMcpAgentAlias, resolveMcpConfigTarget, resolveTargetAgents, transformServerConfig, transformServerConfigForAgent, installMcpServerForAgent as updateMcpServerForAgent, installMcpServerForAgents as updateMcpServerForAgents, wizardAdd, wizardManage, wizardRemove, writeServerToConfigFile };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { Command } from 'commander';
+
 type McpAgentType = "amp" | "antigravity" | "antigravity-cli" | "augment" | "cline" | "cline-cli" | "claude-code" | "claude-desktop" | "codex" | "cursor" | "gemini-cli" | "grok" | "goose" | "github-copilot-cli" | "kimi-code-cli" | "kiro" | "opencode" | "pi" | "qoder" | "qwen-code" | "trae" | "vscode" | "zed";
 type McpConfigFormat = "json" | "jsonc" | "yaml" | "toml";
 type McpTransportType = "http" | "sse" | "stdio";
@@ -272,7 +274,19 @@ interface WizardAddOptions extends McpScopeOptions {
 }
 declare const wizardAdd: (initial?: WizardAddOptions) => Promise<boolean>;
 
-type WizardManageOptions = McpScopeOptions;
+interface WizardManageOptions extends McpScopeOptions {
+    serverName?: string;
+}
+/**
+ * Reusable display function for server details with secret masking.
+ */
+declare const displayServerDetails: ({ serverName, config, agents, isGlobal, titlePrefix, }: {
+    serverName: string;
+    config: McpServerConfig;
+    agents?: McpAgentType[];
+    isGlobal?: boolean;
+    titlePrefix?: string;
+}) => void;
 declare const wizardManage: (options?: WizardManageOptions) => Promise<void>;
 
 interface WizardRemoveOptions extends McpScopeOptions {
@@ -281,6 +295,39 @@ interface WizardRemoveOptions extends McpScopeOptions {
 }
 declare const wizardRemove: (options?: WizardRemoveOptions) => Promise<boolean>;
 
+interface PromptEditKeyValueOptions {
+    title: string;
+    itemNoun: string;
+    itemsNoun: string;
+    maskValue: (key: string, value: string) => string;
+    isSecretKey: (key: string) => boolean;
+    formatText: (items: Record<string, string>) => string;
+    parseText: (text: string) => Record<string, string>;
+    editorPostfix?: string;
+    editorMessage: string;
+    pasteMessage: string;
+    keyPromptMessage: string;
+    valuePromptMessage: string;
+    separator: "=" | ":";
+}
+/**
+ * Generic reusable interactive key-value editing loop supporting:
+ * - Editor launch with pre-filled content ($EDITOR)
+ * - Single item upsert (with secret detection & password masking)
+ * - Single item deletion
+ * - Multiline paste (with merge or replace choices)
+ * - Clear all items
+ */
+declare const promptEditKeyValueConfig: (currentItems: Record<string, string> | undefined, options: PromptEditKeyValueOptions) => Promise<Record<string, string>>;
+
+/**
+ * Masks sensitive values for secure CLI display.
+ */
+declare const maskSecretValue: (key: string, value: string) => string;
+/**
+ * Formats a key-value env record into .env formatted multiline string.
+ */
+declare const formatEnvText: (env: Record<string, string>) => string;
 /**
  * Parses multiline .env formatted text into a key-value record.
  * Supports:
@@ -298,7 +345,20 @@ declare const parseEnvText: (rawText: string) => Record<string, string>;
  * 3. Add key-value one by one (with secret mask detection)
  */
 declare const promptEnvConfig: (initialEnv?: Record<string, string>) => Promise<Record<string, string>>;
+/**
+ * Dedicated prompt loop for inspecting, modifying, adding, and removing
+ * environment variables of an existing MCP server configuration.
+ */
+declare const promptEditEnvConfig: (currentEnv?: Record<string, string>) => Promise<Record<string, string>>;
 
+/**
+ * Masks sensitive HTTP header values for secure CLI display.
+ */
+declare const maskSecretHeader: (key: string, value: string) => string;
+/**
+ * Formats a key-value headers record into multiline Key: Value text.
+ */
+declare const formatHeadersText: (headers: Record<string, string>) => string;
 /**
  * Parses multiline HTTP headers text (Key: Value or Key=Value) into a Record<string, string>.
  */
@@ -307,6 +367,11 @@ declare const parseHeadersText: (rawText: string) => Record<string, string>;
  * Interactively prompts user for HTTP headers.
  */
 declare const promptHeadersConfig: (initialHeaders?: Record<string, string>) => Promise<Record<string, string>>;
+/**
+ * Dedicated prompt loop for inspecting, modifying, adding, and removing
+ * HTTP headers of an existing MCP server configuration.
+ */
+declare const promptEditHeadersConfig: (currentHeaders?: Record<string, string>) => Promise<Record<string, string>>;
 
 /**
  * Parses a command-line argument string into an array of arguments,
@@ -317,6 +382,15 @@ declare const parseArgsString: (rawText: string) => string[];
  * Prompts the user for additional command-line arguments.
  */
 declare const promptArgsConfig: (initialArgs?: string[]) => Promise<string[]>;
+/**
+ * Formats an array of argument strings into a space-separated CLI string,
+ * quoting arguments containing spaces or quotes.
+ */
+declare const formatArgsString: (args: string[]) => string;
+/**
+ * Dedicated prompt for editing command arguments with current arguments pre-filled.
+ */
+declare const promptEditArgs: (currentArgs?: string[]) => Promise<string[]>;
 
 interface PromptScopeAndAgentsOptions extends McpScopeOptions {
     defaultGlobal?: boolean;
@@ -342,6 +416,8 @@ interface PromptScopeOptions extends McpScopeOptions {
  */
 declare const promptScope: (options?: PromptScopeOptions) => Promise<boolean>;
 
+declare const mcpManageCommand: Command;
+
 interface GroupedInstalledServer {
     serverName: string;
     agents: McpAgentType[];
@@ -375,4 +451,4 @@ declare const transformServerConfigForAgent: (agent: McpAgentConfig, serverName:
     global: boolean;
 }) => unknown;
 
-export { AgentConfigStore, type AgentConfigStoreListResult, type AgentConfigStoreRemoveResult, type AgentConfigStoreWriteResult, type ConfigStoreAdapter, type ConfigTargetDescriptor, DEFAULT_REMOTE_TRANSPORT, type GroupedInstalledServer, type IncompatibleAgent, type InstallMcpServerOptions, type InstallMcpServerResult, type ListedMcpServer, type McpAgentConfig, type McpAgentType, type McpConfigFormat, type McpInstallResultForAgent, type McpRemoteServerConfig, type McpRemoteTransport, type McpScopeOptions, type McpServerConfig, type McpSourceType, type McpStdioServerConfig, type McpTransportType, NPX_COMMAND, NPX_DASH_Y, type ParsedMcpSource, type RemoveMcpServerOptions, type RemoveMcpServerResult, type ServerConfigDialect, type ServerConfigDialectName, type ServerConfigDialectOptions, type TargetResolutionQuery, type TargetResolutionResult, installMcpServer as add, agentConfigStore, buildMcpServerConfig, createAgentTransform, detectGloballyInstalledMcpAgents, detectProjectInstalledMcpAgents, extractPackageName, getMcpAgentConfig, getMcpAgentTypes, getMcpAgentsSupportingProjectScope, groupInstalledServersByName, installMcpServer as install, installMcpServer, installMcpServerForAgent, installMcpServerForAgents, isMcpAgentType, isMcpTransportSupported, isRemoteMcpSource, isRemoteServerConfig, isStdioServerConfig, listInstalledMcpServers as list, listInstalledMcpServers, listServersInConfigFile, mainMenu, mcpAgentAliases, mcpAgents, normalizeServerConfig, parseArgsString, parseEnvText, parseHeadersText, parseMcpSource, parseServerConfig, parseMcpSource as parseSource, promptArgsConfig, promptEnvConfig, promptHeadersConfig, promptScope, promptScopeAndAgents, readConfigFile, removeMcpServer as remove, removeMcpServer, removeMcpServerFromAgent, removeServerFromConfigFile, resolveMcpAgentAlias, resolveMcpConfigTarget, resolveTargetAgents, transformServerConfig, transformServerConfigForAgent, wizardAdd, wizardManage, wizardRemove, writeServerToConfigFile };
+export { AgentConfigStore, type AgentConfigStoreListResult, type AgentConfigStoreRemoveResult, type AgentConfigStoreWriteResult, type ConfigStoreAdapter, type ConfigTargetDescriptor, DEFAULT_REMOTE_TRANSPORT, type GroupedInstalledServer, type IncompatibleAgent, type InstallMcpServerOptions, type InstallMcpServerResult, type ListedMcpServer, type McpAgentConfig, type McpAgentType, type McpConfigFormat, type McpInstallResultForAgent, type McpRemoteServerConfig, type McpRemoteTransport, type McpScopeOptions, type McpServerConfig, type McpSourceType, type McpStdioServerConfig, type McpTransportType, NPX_COMMAND, NPX_DASH_Y, type ParsedMcpSource, type PromptEditKeyValueOptions, type RemoveMcpServerOptions, type RemoveMcpServerResult, type ServerConfigDialect, type ServerConfigDialectName, type ServerConfigDialectOptions, type TargetResolutionQuery, type TargetResolutionResult, type WizardManageOptions, installMcpServer as add, agentConfigStore, buildMcpServerConfig, createAgentTransform, detectGloballyInstalledMcpAgents, detectProjectInstalledMcpAgents, displayServerDetails, extractPackageName, formatArgsString, formatEnvText, formatHeadersText, getMcpAgentConfig, getMcpAgentTypes, getMcpAgentsSupportingProjectScope, groupInstalledServersByName, installMcpServer as install, installMcpServer, installMcpServerForAgent, installMcpServerForAgents, isMcpAgentType, isMcpTransportSupported, isRemoteMcpSource, isRemoteServerConfig, isStdioServerConfig, listInstalledMcpServers as list, listInstalledMcpServers, listServersInConfigFile, mainMenu, maskSecretHeader, maskSecretValue, mcpAgentAliases, mcpAgents, mcpManageCommand, normalizeServerConfig, parseArgsString, parseEnvText, parseHeadersText, parseMcpSource, parseServerConfig, parseMcpSource as parseSource, promptArgsConfig, promptEditArgs, promptEditEnvConfig, promptEditHeadersConfig, promptEditKeyValueConfig, promptEnvConfig, promptHeadersConfig, promptScope, promptScopeAndAgents, readConfigFile, removeMcpServer as remove, removeMcpServer, removeMcpServerFromAgent, removeServerFromConfigFile, resolveMcpAgentAlias, resolveMcpConfigTarget, resolveTargetAgents, transformServerConfig, transformServerConfigForAgent, installMcpServerForAgent as updateMcpServerForAgent, installMcpServerForAgents as updateMcpServerForAgents, wizardAdd, wizardManage, wizardRemove, writeServerToConfigFile };

package/dist/index.js

@@ -8,7 +8,11 @@ import {
   createAgentTransform,
   detectGloballyInstalledMcpAgents,
   detectProjectInstalledMcpAgents,
+  displayServerDetails,
   extractPackageName,
+  formatArgsString,
+  formatEnvText,
+  formatHeadersText,
   getMcpAgentConfig,
   getMcpAgentTypes,
   getMcpAgentsSupportingProjectScope,
@@ -24,8 +28,11 @@ import {
   listInstalledMcpServers,
   listServersInConfigFile,
   mainMenu,
+  maskSecretHeader,
+  maskSecretValue,
   mcpAgentAliases,
   mcpAgents,
+  mcpManageCommand,
   normalizeServerConfig,
   parseArgsString,
   parseEnvText,
@@ -33,6 +40,10 @@ import {
   parseMcpSource,
   parseServerConfig,
   promptArgsConfig,
+  promptEditArgs,
+  promptEditEnvConfig,
+  promptEditHeadersConfig,
+  promptEditKeyValueConfig,
   promptEnvConfig,
   promptHeadersConfig,
   promptScope,
@@ -50,7 +61,7 @@ import {
   wizardManage,
   wizardRemove,
   writeServerToConfigFile
-} from "./chunk-XW2KL6W3.js";
+} from "./chunk-7V5XL4RI.js";
 export {
   AgentConfigStore,
   DEFAULT_REMOTE_TRANSPORT,
@@ -62,7 +73,11 @@ export {
   createAgentTransform,
   detectGloballyInstalledMcpAgents,
   detectProjectInstalledMcpAgents,
+  displayServerDetails,
   extractPackageName,
+  formatArgsString,
+  formatEnvText,
+  formatHeadersText,
   getMcpAgentConfig,
   getMcpAgentTypes,
   getMcpAgentsSupportingProjectScope,
@@ -80,8 +95,11 @@ export {
   listInstalledMcpServers,
   listServersInConfigFile,
   mainMenu,
+  maskSecretHeader,
+  maskSecretValue,
   mcpAgentAliases,
   mcpAgents,
+  mcpManageCommand,
   normalizeServerConfig,
   parseArgsString,
   parseEnvText,
@@ -90,6 +108,10 @@ export {
   parseServerConfig,
   parseMcpSource as parseSource,
   promptArgsConfig,
+  promptEditArgs,
+  promptEditEnvConfig,
+  promptEditHeadersConfig,
+  promptEditKeyValueConfig,
   promptEnvConfig,
   promptHeadersConfig,
   promptScope,
@@ -104,6 +126,8 @@ export {
   resolveTargetAgents,
   transformServerConfig,
   transformServerConfigForAgent,
+  installMcpServerForAgent as updateMcpServerForAgent,
+  installMcpServerForAgents as updateMcpServerForAgents,
   wizardAdd,
   wizardManage,
   wizardRemove,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wuyax/mcps",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.2",
   "description": "Cross-platform MCP (Model Context Protocol) server installer and manager for AI coding agents",
   "type": "module",
   "main": "dist/index.js",