add-mcp 1.5.1 → 1.6.0

package/README.md

@@ -43,6 +43,9 @@ npx add-mcp "npx -y @org/mcp-server --flag value"
 # Node.js script
 npx add-mcp "node /path/to/server.js --port 3000"
 
+# Local stdio server with environment variables (repeatable)
+npx add-mcp @modelcontextprotocol/server-filesystem --env "API_KEY=secret" --env "DATABASE_URL=postgres://localhost/app"
+
 # Install for Cursor and Claude Code
 npx add-mcp https://mcp.example.com/mcp -a cursor -a claude-code
 
@@ -68,6 +71,7 @@ npx add-mcp https://mcp.example.com/mcp -a cursor -y --gitignore
 | `-t, --transport <type>` | Transport type for remote servers: `http` (default), `sse`               |
 | `--type <type>`          | Alias for `--transport`                                                  |
 | `--header <header>`      | HTTP header for remote servers (repeatable, `Key: Value`)                |
+| `--env <env>`            | Env var for local stdio servers (repeatable, `KEY=VALUE`)                |
 | `-n, --name <name>`      | Server name (auto-inferred if not provided)                              |
 | `-y, --yes`              | Skip all confirmation prompts                                            |
 | `--all`                  | Install to all agents                                                    |
@@ -132,6 +136,11 @@ Note that some agents like Cursor and opencode do not require the `type` informa
 Use `--header` to pass custom headers for remote servers. The flag can be repeated.
 Header support is available for remote installs across all supported agents.
 
+## Environment Variables
+
+Use `--env` to pass environment variables for local stdio servers (packages/commands). The flag can be repeated and expects `KEY=VALUE`.
+If `--env` is provided for a remote URL install, it is ignored with a warning.
+
 ## Supported Agents
 
 MCP servers can be installed to any of these agents:

package/dist/index.js

@@ -946,28 +946,36 @@ function buildConfigWithKey(configKey, serverName, serverConfig) {
 // src/installer.ts
 function buildServerConfig(parsed, options = {}) {
   if (parsed.type === "remote") {
-    const config = {
+    const config2 = {
       type: options.transport ?? "http",
       url: parsed.value
     };
     if (options.headers && Object.keys(options.headers).length > 0) {
-      config.headers = options.headers;
+      config2.headers = options.headers;
     }
-    return config;
+    return config2;
   }
   if (parsed.type === "command") {
     const parts = parsed.value.split(" ");
     const command = parts[0];
     const args = parts.slice(1);
-    return {
+    const config2 = {
       command,
       args
     };
+    if (options.env && Object.keys(options.env).length > 0) {
+      config2.env = options.env;
+    }
+    return config2;
   }
-  return {
+  const config = {
     command: "npx",
     args: ["-y", parsed.value]
   };
+  if (options.env && Object.keys(options.env).length > 0) {
+    config.env = options.env;
+  }
+  return config;
 }
 function updateGitignoreWithPaths(paths, options = {}) {
   const cwd = options.cwd || process.cwd();
@@ -1069,7 +1077,7 @@ function installServer(serverName, serverConfig, agentTypes, options = {}) {
 // package.json
 var package_default = {
   name: "add-mcp",
-  version: "1.5.1",
+  version: "1.6.0",
   description: "Add MCP servers to your favorite coding agents with a single command.",
   author: "Andre Landgraf <andre@neon.tech>",
   license: "Apache-2.0",
@@ -1205,6 +1213,25 @@ function parseHeaders(values) {
   }
   return { headers, invalid };
 }
+function parseEnv(values) {
+  const env = {};
+  const invalid = [];
+  for (const entry of values) {
+    const separatorIndex = entry.indexOf("=");
+    if (separatorIndex <= 0) {
+      invalid.push(entry);
+      continue;
+    }
+    const key = entry.slice(0, separatorIndex).trim();
+    const value = entry.slice(separatorIndex + 1);
+    if (!key) {
+      invalid.push(entry);
+      continue;
+    }
+    env[key] = value;
+  }
+  return { env, invalid };
+}
 program.name("add-mcp").description(
   "Install MCP servers for coding agents (Claude Code, Cursor, VS Code, OpenCode, Codex, and more \u2014 run list-agents for the full list)"
 ).version(version).argument("[target]", "MCP server URL (remote) or package name (local stdio)").option(
@@ -1221,6 +1248,11 @@ program.name("add-mcp").description(
   "HTTP header for remote servers (repeatable, 'Key: Value')",
   collect,
   []
+).option(
+  "--env <env>",
+  "Environment variable for local stdio servers (repeatable, 'KEY=VALUE')",
+  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) => {
   await main(target, options);
 });
@@ -1321,6 +1353,21 @@ async function main(target, options) {
   if (hasHeaderValues && !isRemote) {
     p2.log.warn("--header is only used for remote URLs, ignoring");
   }
+  const envValues = options.env ?? [];
+  const envResult = parseEnv(envValues);
+  if (envResult.invalid.length > 0) {
+    p2.log.error(
+      `Invalid --env value(s): ${envResult.invalid.join(", ")}. Use "KEY=VALUE" format.`
+    );
+    process.exit(1);
+  }
+  const envKeys = Object.keys(envResult.env);
+  const hasEnvValues = envKeys.length > 0;
+  if (hasEnvValues && isRemote) {
+    p2.log.warn(
+      "--env is only used for local/package/command installs, ignoring"
+    );
+  }
   const serverName = options.name || parsed.inferredName;
   p2.log.info(`Server name: ${chalk.cyan(serverName)}`);
   const transportValue = options.transport || options.type;
@@ -1340,7 +1387,8 @@ async function main(target, options) {
   }
   const serverConfig = buildServerConfig(parsed, {
     transport: resolvedTransport,
-    headers: isRemote && hasHeaderValues ? headerResult.headers : void 0
+    headers: isRemote && hasHeaderValues ? headerResult.headers : void 0,
+    env: !isRemote && hasEnvValues ? envResult.env : void 0
   });
   let targetAgents;
   const allAgentTypes = getAgentTypes();

package/package.json

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