add-mcp 1.9.0 → 1.9.1

package/dist/index.js

@@ -2085,7 +2085,7 @@ function findMatchingServers(agentServersList, query) {
 // package.json
 var package_default = {
   name: "add-mcp",
-  version: "1.9.0",
+  version: "1.9.1",
   description: "Add MCP servers to your favorite coding agents with a single command.",
   author: "Andre Landgraf <andre@neon.tech>",
   license: "Apache-2.0",
@@ -2331,6 +2331,16 @@ function inferFindPreferredTransport(options) {
 function collect(value, previous) {
   return previous.concat([value]);
 }
+function looksLikeEatenShellVar(invalidEntries, separator) {
+  for (const entry of invalidEntries) {
+    const separatorIndex = entry.indexOf(separator);
+    if (separatorIndex <= 0) continue;
+    const key = entry.slice(0, separatorIndex).trim();
+    const value = entry.slice(separatorIndex + 1).trim();
+    if (key && !value) return true;
+  }
+  return false;
+}
 function parseHeaders(values) {
   const headers = {};
   const invalid = [];
@@ -2360,8 +2370,8 @@ function parseEnv(values) {
       continue;
     }
     const key = entry.slice(0, separatorIndex).trim();
-    const value = entry.slice(separatorIndex + 1);
-    if (!key) {
+    const value = entry.slice(separatorIndex + 1).trim();
+    if (!key || !value) {
       invalid.push(entry);
       continue;
     }
@@ -2389,17 +2399,17 @@ program.name("add-mcp").description(
   "Transport type for remote servers (http, sse)"
 ).option("--type <type>", "Alias for --transport").option(
   "--header <header>",
-  "HTTP header for remote servers (repeatable, 'Key: Value'). Placeholders ${VAR} prompt interactively when not using --yes.",
+  "HTTP header for remote servers (repeatable, 'Key: Value'). Placeholders ${VAR} prompt interactively when not using --yes. Use single quotes so your shell does not expand the ${VAR}.",
   collect,
   []
 ).option(
   "--env <env>",
-  "Environment variable for local stdio servers (repeatable, 'KEY=VALUE'). Placeholders ${VAR} prompt interactively when not using --yes.",
+  "Environment variable for local stdio servers (repeatable, 'KEY=VALUE'). Placeholders ${VAR} prompt interactively when not using --yes. Use single quotes so your shell does not expand the ${VAR}.",
   collect,
   []
 ).option(
   "--args <arg>",
-  "Argument for local stdio servers (repeatable). Placeholders ${VAR} prompt interactively when not using --yes.",
+  "Argument for local stdio servers (repeatable). Placeholders ${VAR} prompt interactively when not using --yes. Use single quotes so your shell does not expand the ${VAR}.",
   collect,
   []
 ).option("-y, --yes", "Skip confirmation prompts").option("--all", "Install to all agents").option("--gitignore", "Add generated project config files to .gitignore").action(async (target, options) => {
@@ -2981,8 +2991,9 @@ async function main(target, options) {
   const headerValues = options.header ?? [];
   const headerResult = parseHeaders(headerValues);
   if (headerResult.invalid.length > 0) {
+    const hint = looksLikeEatenShellVar(headerResult.invalid, ":") ? " (looks like your shell expanded a ${VAR} to an empty string; use single quotes: --header 'Key: ${VAR}' to pass the template literally)" : "";
     p3.log.error(
-      `Invalid --header value(s): ${headerResult.invalid.join(", ")}. Use "Key: Value" format.`
+      `Invalid --header value(s): ${headerResult.invalid.join(", ")}. Use "Key: Value" format.${hint}`
     );
     process.exit(1);
   }
@@ -2994,8 +3005,9 @@ async function main(target, options) {
   const envValues = options.env ?? [];
   const envResult = parseEnv(envValues);
   if (envResult.invalid.length > 0) {
+    const hint = looksLikeEatenShellVar(envResult.invalid, "=") ? " (looks like your shell expanded a ${VAR} to an empty string; use single quotes: --env 'KEY=${VAR}' to pass the template literally)" : "";
     p3.log.error(
-      `Invalid --env value(s): ${envResult.invalid.join(", ")}. Use "KEY=VALUE" format.`
+      `Invalid --env value(s): ${envResult.invalid.join(", ")}. Use "KEY=VALUE" format.${hint}`
     );
     process.exit(1);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "add-mcp",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "description": "Add MCP servers to your favorite coding agents with a single command.",
   "author": "Andre Landgraf <andre@neon.tech>",
   "license": "Apache-2.0",