add-mcp 1.0.1 → 1.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 Add MCP servers to your favorite coding agents with a single command.
 
-Supports **Claude Code**, **Codex**, **Cursor**, **OpenCode**, **VSCode** and [4 more](#supported-agents).
+Supports **Claude Code**, **Codex**, **Cursor**, **OpenCode**, **VSCode** and [5 more](#supported-agents).
 
 ## Install an MCP Server
 
@@ -54,6 +54,9 @@ npx add-mcp mcp-server-github --all
 
 # Install to all agents, globally, without prompts
 npx add-mcp mcp-server-github --all -g -y
+
+# Add generated config files to .gitignore
+npx add-mcp https://mcp.example.com/mcp -a cursor -y --gitignore
 ```
 
 ### Options
@@ -68,6 +71,7 @@ npx add-mcp mcp-server-github --all -g -y
 | `-n, --name <name>`      | Server name (auto-inferred if not provided)                              |
 | `-y, --yes`              | Skip all confirmation prompts                                            |
 | `--all`                  | Install to all agents                                                    |
+| `--gitignore`            | Add generated config files to `.gitignore`                                |
 
 ### Additional Commands
 
@@ -135,17 +139,18 @@ Agents that do not support headers: Goose.
 
 MCP servers can be installed to any of these agents:
 
-| Agent          | `--agent`        | Project Path            | Global Path                                                       |
-| -------------- | ---------------- | ----------------------- | ----------------------------------------------------------------- |
-| Claude Code    | `claude-code`    | `.mcp.json`             | `~/.claude.json`                                                  |
-| Claude Desktop | `claude-desktop` | -                       | `~/Library/Application Support/Claude/claude_desktop_config.json` |
-| Codex          | `codex`          | `.codex/config.toml`    | `~/.codex/config.toml`                                            |
-| Cursor         | `cursor`         | `.cursor/mcp.json`      | `~/.cursor/mcp.json`                                              |
-| Gemini CLI     | `gemini-cli`     | `.gemini/settings.json` | `~/.gemini/settings.json`                                         |
-| Goose          | `goose`          | `.goose/config.yaml`    | `~/.config/goose/config.yaml`                                     |
-| OpenCode       | `opencode`       | `opencode.json`         | `~/.config/opencode/opencode.json`                                |
-| VS Code        | `vscode`         | `.vscode/mcp.json`      | `~/Library/Application Support/Code/User/mcp.json`                |
-| Zed            | `zed`            | `.zed/settings.json`    | `~/Library/Application Support/Zed/settings.json`                 |
+| Agent              | `--agent`            | Project Path            | Global Path                                                       |
+| ------------------ | -------------------- | ----------------------- | ----------------------------------------------------------------- |
+| Claude Code        | `claude-code`        | `.mcp.json`             | `~/.claude.json`                                                  |
+| Claude Desktop     | `claude-desktop`     | -                       | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| Codex              | `codex`              | `.codex/config.toml`    | `~/.codex/config.toml`                                            |
+| Cursor             | `cursor`             | `.cursor/mcp.json`      | `~/.cursor/mcp.json`                                              |
+| Gemini CLI         | `gemini-cli`         | `.gemini/settings.json` | `~/.gemini/settings.json`                                         |
+| Goose              | `goose`              | `.goose/config.yaml`    | `~/.config/goose/config.yaml`                                     |
+| GitHub Copilot CLI | `github-copilot-cli` | `.vscode/mcp.json`      | `~/.copilot/mcp-config.json`                                      |
+| OpenCode           | `opencode`           | `opencode.json`         | `~/.config/opencode/opencode.json`                                |
+| VS Code            | `vscode`             | `.vscode/mcp.json`      | `~/Library/Application Support/Code/User/mcp.json`                |
+| Zed                | `zed`                | `.zed/settings.json`    | `~/Library/Application Support/Zed/settings.json`                 |
 
 **Aliases:** `gemini` → `gemini-cli`, `github-copilot` → `vscode`
 

package/dist/index.js

@@ -15,7 +15,7 @@ var agentAliases = {
 // src/agents.ts
 import * as p from "@clack/prompts";
 import { homedir as homedir2 } from "os";
-import { join as join2 } from "path";
+import { dirname as dirname2, join as join2 } from "path";
 import { existsSync } from "fs";
 
 // src/mcp-lock.ts
@@ -98,6 +98,10 @@ function getPlatformPaths() {
   }
 }
 var { appSupport, vscodePath, gooseConfigPath } = getPlatformPaths();
+var copilotConfigPath = join2(
+  process.env.XDG_CONFIG_HOME || join2(home, ".copilot"),
+  "mcp-config.json"
+);
 function transformGooseConfig(serverName, config) {
   if (config.url) {
     const gooseType = config.type === "sse" ? "sse" : "streamable_http";
@@ -180,6 +184,32 @@ function transformCursorConfig(_serverName, config) {
   }
   return config;
 }
+function transformGitHubCopilotCliConfig(_serverName, config, context) {
+  if (context?.local) {
+    return config;
+  }
+  if (config.url) {
+    const remoteConfig = {
+      type: config.type || "http",
+      url: config.url,
+      tools: ["*"]
+    };
+    if (config.headers && Object.keys(config.headers).length > 0) {
+      remoteConfig.headers = config.headers;
+    }
+    return remoteConfig;
+  }
+  const localConfig = {
+    type: "stdio",
+    command: config.command,
+    args: config.args || [],
+    tools: ["*"]
+  };
+  if (config.env && Object.keys(config.env).length > 0) {
+    localConfig.env = config.env;
+  }
+  return localConfig;
+}
 var agents = {
   "claude-code": {
     name: "claude-code",
@@ -271,6 +301,22 @@ var agents = {
     },
     transformConfig: transformGooseConfig
   },
+  "github-copilot-cli": {
+    name: "github-copilot-cli",
+    displayName: "GitHub Copilot CLI",
+    configPath: copilotConfigPath,
+    localConfigPath: ".vscode/mcp.json",
+    projectDetectPaths: [".vscode"],
+    configKey: "mcpServers",
+    localConfigKey: "servers",
+    format: "json",
+    supportedTransports: ["stdio", "http", "sse"],
+    supportsHeaders: true,
+    detectGlobalInstall: async () => {
+      return existsSync(dirname2(copilotConfigPath));
+    },
+    transformConfig: transformGitHubCopilotCliConfig
+  },
   opencode: {
     name: "opencode",
     displayName: "OpenCode",
@@ -596,12 +642,12 @@ function isRemoteSource(parsed) {
 }
 
 // src/installer.ts
-import { existsSync as existsSync5, mkdirSync as mkdirSync4 } from "fs";
-import { join as join3, dirname as dirname5 } from "path";
+import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync4 } from "fs";
+import { join as join3, dirname as dirname6, isAbsolute, relative, sep } from "path";
 
 // src/formats/json.ts
 import { readFileSync, writeFileSync, existsSync as existsSync2, mkdirSync } from "fs";
-import { dirname as dirname2 } from "path";
+import { dirname as dirname3 } from "path";
 import * as jsonc from "jsonc-parser";
 
 // src/formats/utils.ts
@@ -652,7 +698,7 @@ function detectIndent(text) {
   return result || { tabSize: 2, insertSpaces: true };
 }
 function writeJsonConfig(filePath, config, configKey) {
-  const dir = dirname2(filePath);
+  const dir = dirname3(filePath);
   if (!existsSync2(dir)) {
     mkdirSync(dir, { recursive: true });
   }
@@ -694,7 +740,7 @@ function setNestedValue(obj, path, value) {
 
 // src/formats/yaml.ts
 import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync3, mkdirSync as mkdirSync2 } from "fs";
-import { dirname as dirname3 } from "path";
+import { dirname as dirname4 } from "path";
 import yaml from "js-yaml";
 function readYamlConfig(filePath) {
   if (!existsSync3(filePath)) {
@@ -705,7 +751,7 @@ function readYamlConfig(filePath) {
   return parsed || {};
 }
 function writeYamlConfig(filePath, config) {
-  const dir = dirname3(filePath);
+  const dir = dirname4(filePath);
   if (!existsSync3(dir)) {
     mkdirSync2(dir, { recursive: true });
   }
@@ -724,7 +770,7 @@ function writeYamlConfig(filePath, config) {
 
 // src/formats/toml.ts
 import { readFileSync as readFileSync3, writeFileSync as writeFileSync3, existsSync as existsSync4, mkdirSync as mkdirSync3 } from "fs";
-import { dirname as dirname4 } from "path";
+import { dirname as dirname5 } from "path";
 import * as TOML from "@iarna/toml";
 function readTomlConfig(filePath) {
   if (!existsSync4(filePath)) {
@@ -735,7 +781,7 @@ function readTomlConfig(filePath) {
   return parsed;
 }
 function writeTomlConfig(filePath, config) {
-  const dir = dirname4(filePath);
+  const dir = dirname5(filePath);
   if (!existsSync4(dir)) {
     mkdirSync3(dir, { recursive: true });
   }
@@ -798,6 +844,41 @@ function buildServerConfig(parsed, options = {}) {
     args: ["-y", parsed.value]
   };
 }
+function updateGitignoreWithPaths(paths, options = {}) {
+  const cwd = options.cwd || process.cwd();
+  const gitignorePath = join3(cwd, ".gitignore");
+  const existingContent = existsSync5(gitignorePath) ? readFileSync4(gitignorePath, "utf-8") : "";
+  const existingEntries = new Set(
+    existingContent.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0)
+  );
+  const entriesToAdd = [];
+  for (const filePath of paths) {
+    const relativePath = isAbsolute(filePath) ? relative(cwd, filePath) : filePath;
+    if (!relativePath || relativePath.startsWith("..") || isAbsolute(relativePath)) {
+      continue;
+    }
+    const normalizedPath = relativePath.split(sep).join("/");
+    const cleanPath = normalizedPath.startsWith("./") ? normalizedPath.slice(2) : normalizedPath;
+    if (!cleanPath || cleanPath === ".gitignore" || existingEntries.has(cleanPath)) {
+      continue;
+    }
+    existingEntries.add(cleanPath);
+    entriesToAdd.push(cleanPath);
+  }
+  if (entriesToAdd.length > 0) {
+    let nextContent = existingContent;
+    if (nextContent.length > 0 && !nextContent.endsWith("\n")) {
+      nextContent += "\n";
+    }
+    nextContent += `${entriesToAdd.join("\n")}
+`;
+    writeFileSync4(gitignorePath, nextContent, "utf-8");
+  }
+  return {
+    path: gitignorePath,
+    added: entriesToAdd
+  };
+}
 function getConfigPath(agent, options = {}) {
   if (options.local && agent.localConfigPath) {
     const cwd = options.cwd || process.cwd();
@@ -805,21 +886,26 @@ function getConfigPath(agent, options = {}) {
   }
   return agent.configPath;
 }
+function getConfigKey(agent, options = {}) {
+  if (options.local && agent.localConfigKey) {
+    return agent.localConfigKey;
+  }
+  return agent.configKey;
+}
 function installServerForAgent(serverName, serverConfig, agentType, options = {}) {
   const agent = agents[agentType];
   const configPath = getConfigPath(agent, options);
   try {
-    const dir = dirname5(configPath);
+    const dir = dirname6(configPath);
     if (!existsSync5(dir)) {
       mkdirSync4(dir, { recursive: true });
     }
-    const transformedConfig = agent.transformConfig ? agent.transformConfig(serverName, serverConfig) : serverConfig;
-    const config = buildConfigWithKey(
-      agent.configKey,
-      serverName,
-      transformedConfig
-    );
-    writeConfig(configPath, config, agent.format, agent.configKey);
+    const transformedConfig = agent.transformConfig ? agent.transformConfig(serverName, serverConfig, {
+      local: Boolean(options.local)
+    }) : serverConfig;
+    const configKey = getConfigKey(agent, options);
+    const config = buildConfigWithKey(configKey, serverName, transformedConfig);
+    writeConfig(configPath, config, agent.format, configKey);
     return {
       success: true,
       path: configPath
@@ -854,7 +940,7 @@ function installServer(serverName, serverConfig, agentTypes, options = {}) {
 // package.json
 var package_default = {
   name: "add-mcp",
-  version: "1.0.1",
+  version: "1.2.0",
   description: "Add MCP servers to your favorite coding agents with a single command.",
   author: "Andre Landgraf <andre@neon.tech>",
   license: "Apache-2.0",
@@ -870,9 +956,9 @@ var package_default = {
     fmt: "prettier --write .",
     build: "tsup src/index.ts --format esm --dts --clean",
     dev: "tsx src/index.ts",
-    test: "tsx tests/source-parser.test.ts && tsx tests/agents.test.ts && tsx tests/mcp-lock.test.ts && tsx tests/installer.test.ts && tsx tests/e2e/install.test.ts",
+    test: "tsx tests/source-parser.test.ts && tsx tests/agents.test.ts && tsx tests/mcp-lock.test.ts && tsx tests/installer.test.ts && tsx tests/e2e/install.test.ts && tsx tests/e2e/cli.test.ts",
     "test:unit": "tsx tests/source-parser.test.ts && tsx tests/agents.test.ts && tsx tests/mcp-lock.test.ts && tsx tests/installer.test.ts",
-    "test:e2e": "tsx tests/e2e/install.test.ts",
+    "test:e2e": "tsx tests/e2e/install.test.ts && tsx tests/e2e/cli.test.ts",
     typecheck: "tsc --noEmit",
     prepublishOnly: "npm run build"
   },
@@ -885,6 +971,7 @@ var package_default = {
     "claude-desktop",
     "codex",
     "cursor",
+    "github-copilot-cli",
     "gemini-cli",
     "goose",
     "opencode",
@@ -1002,7 +1089,10 @@ program.name("add-mcp").description(
   "HTTP header for remote servers (repeatable, 'Key: Value')",
   collect,
   []
-).option("-y, --yes", "Skip confirmation prompts").option("--all", "Install to all agents").action(async (target, options) => {
+).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);
 });
 program.command("list-agents").description("List all supported coding agents").action(() => {
@@ -1411,6 +1501,21 @@ async function main(target, options) {
       );
     }
   }
+  if (options.gitignore && options.global) {
+    p2.log.warn(
+      "--gitignore is only supported for project-scoped installations; ignoring."
+    );
+  } else if (options.gitignore) {
+    const successfulPaths = successful.map(([_, result]) => result.path);
+    const gitignoreUpdate = updateGitignoreWithPaths(successfulPaths);
+    if (gitignoreUpdate.added.length > 0) {
+      p2.log.info(
+        `Added ${gitignoreUpdate.added.length} entr${gitignoreUpdate.added.length === 1 ? "y" : "ies"} to .gitignore`
+      );
+    } else {
+      p2.log.info("No new local config paths to add to .gitignore");
+    }
+  }
   console.log();
   p2.outro(chalk.green("Done!"));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "add-mcp",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "Add MCP servers to your favorite coding agents with a single command.",
   "author": "Andre Landgraf <andre@neon.tech>",
   "license": "Apache-2.0",
@@ -16,9 +16,9 @@
     "fmt": "prettier --write .",
     "build": "tsup src/index.ts --format esm --dts --clean",
     "dev": "tsx src/index.ts",
-    "test": "tsx tests/source-parser.test.ts && tsx tests/agents.test.ts && tsx tests/mcp-lock.test.ts && tsx tests/installer.test.ts && tsx tests/e2e/install.test.ts",
+    "test": "tsx tests/source-parser.test.ts && tsx tests/agents.test.ts && tsx tests/mcp-lock.test.ts && tsx tests/installer.test.ts && tsx tests/e2e/install.test.ts && tsx tests/e2e/cli.test.ts",
     "test:unit": "tsx tests/source-parser.test.ts && tsx tests/agents.test.ts && tsx tests/mcp-lock.test.ts && tsx tests/installer.test.ts",
-    "test:e2e": "tsx tests/e2e/install.test.ts",
+    "test:e2e": "tsx tests/e2e/install.test.ts && tsx tests/e2e/cli.test.ts",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run build"
   },
@@ -31,6 +31,7 @@
     "claude-desktop",
     "codex",
     "cursor",
+    "github-copilot-cli",
     "gemini-cli",
     "goose",
     "opencode",