add-mcp 0.3.4 → 0.4.0

package/README.md

@@ -10,10 +10,10 @@ Supports **OpenCode**, **Claude Code**, **Codex**, **Cursor**, and [5 more](#sup
 npx add-mcp https://mcp.example.com/sse
 ```
 
-### Source Formats
+### Usage Examples
 
 ```bash
-# Remote MCP server (HTTP streamable - default)
+# Remote MCP server (streamable HTTP)
 npx add-mcp https://mcp.example.com/mcp
 
 # Remote MCP server (SSE transport)
@@ -22,11 +22,29 @@ npx add-mcp https://mcp.example.com/sse --transport sse
 # npm package (runs via npx)
 npx add-mcp @modelcontextprotocol/server-postgres
 
+# Non-interactive installation to all detected agents in the project directory
+npx add-mcp https://mcp.example.com/mcp -y
+
+# Non-interactive installation to the global Claude Code config
+npx add-mcp https://mcp.example.com/mcp -g -a claude-code -y
+
 # Full command with arguments
 npx add-mcp "npx -y @org/mcp-server --flag value"
 
 # Node.js script
 npx add-mcp "node /path/to/server.js --port 3000"
+
+# Install for Cursor and Claude Code
+npx add-mcp https://mcp.example.com/mcp -a cursor -a claude-code
+
+# Install with custom server name
+npx add-mcp @modelcontextprotocol/server-postgres --name postgres
+
+# Install to all supported agents
+npx add-mcp mcp-server-github --all
+
+# Install to all agents, globally, without prompts
+npx add-mcp mcp-server-github --all -g -y
 ```
 
 ### Options
@@ -41,7 +59,9 @@ npx add-mcp "node /path/to/server.js --port 3000"
 | `-y, --yes`              | Skip all confirmation prompts                                            |
 | `--all`                  | Install to all agents                                                    |
 
-### Commands
+### Additional Commands
+
+Besides the implicit add command, `add-mcp` also supports the following commands:
 
 | Command       | Description                                                  |
 | ------------- | ------------------------------------------------------------ |
@@ -52,28 +72,6 @@ npx add-mcp "node /path/to/server.js --port 3000"
 npx add-mcp list-agents
 ```
 
-### Examples
-
-```bash
-# Install to specific agents
-npx add-mcp https://mcp.example.com/mcp -a cursor -a claude-code
-
-# Install with SSE transport
-npx add-mcp https://mcp.neon.tech/sse --transport sse
-
-# Install with custom server name
-npx add-mcp @modelcontextprotocol/server-postgres --name postgres
-
-# Non-interactive installation (CI/CD friendly)
-npx add-mcp https://mcp.example.com/mcp -g -a claude-code -y
-
-# Install to all agents
-npx add-mcp mcp-server-github --all
-
-# Install to all agents, globally, without prompts
-npx add-mcp mcp-server-github --all -g -y
-```
-
 ### Installation Scope
 
 | Scope       | Flag      | Location                | Use Case                                      |
@@ -103,12 +101,12 @@ The CLI automatically detects agents based on your environment:
 
 ## Transport Types
 
-MCP supports different transport mechanisms for remote servers:
+`add-mcp` supports all three transport types: HTTP, SSE, and stdio. Some agents require `type` option to be set to specify the transport type. You can use the `--type` or `--transport` option to specify the transport type:
 
-| Transport | Flag               | Description                                    |
-| --------- | ------------------ | ---------------------------------------------- |
-| **HTTP**  | `--transport http` | Streamable HTTP (default, modern standard)     |
-| **SSE**   | `--transport sse`  | Server-Sent Events (legacy, still widely used) |
+| Transport | Flag               | Description                                           |
+| --------- | ------------------ | ----------------------------------------------------- |
+| **HTTP**  | `--transport http` | Streamable HTTP (default)                             |
+| **SSE**   | `--transport sse`  | Server-Sent Events (deprecated by MCP but still used) |
 
 Local servers (npm packages, commands) always use **stdio** transport.
 
@@ -120,49 +118,29 @@ MCP servers can be installed to any of these agents:
 | -------------- | ---------------- | ----------------------- | ----------------------------------------------------------------- |
 | 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          | `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`            | -                       | `~/.config/zed/settings.json`                                     |
+| Zed            | `zed`            | `.zed/settings.json`    | `~/Library/Application Support/Zed/settings.json`                 |
 
 **Aliases:** `github-copilot` → `vscode`
 
 The CLI uses smart detection to find agents in your project directory and globally installed agents. See [Smart Detection](#smart-detection) for details.
 
-### Transport Support
-
-Not all agents support all transport types:
-
-| Agent          | stdio | http | sse |
-| -------------- | ----- | ---- | --- |
-| Claude Code    | ✓     | ✓    | ✓   |
-| Claude Desktop | ✓     | ✓    | ✓   |
-| Codex          | ✓     | ✓    | ✓   |
-| Cursor         | ✓     | ✓    | ✓   |
-| Gemini CLI     | ✓     | ✓    | ✓   |
-| Goose          | ✓     | ✓    | ✗   |
-| OpenCode       | ✓     | ✓    | ✓   |
-| VS Code        | ✓     | ✓    | ✓   |
-| Zed            | ✓     | ✓    | ✓   |
-
 ## What are MCP Servers?
 
 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) servers extend your coding agent's capabilities by providing tools, resources, and context. MCP servers can:
 
+- Integrate with external services (Notion, Linear, GitHub, etc.)
 - Connect to databases (PostgreSQL, MySQL, etc.)
-- Integrate with external services (GitHub, Linear, Notion)
 - Provide file system access
 - Offer specialized tools for your workflow
 
 ## Troubleshooting
 
-### Transport mismatch error
-
-If you get an error about transport not being supported, check that the agent supports your chosen transport type. For example, Goose doesn't support SSE transport.
-
 ### Server not loading
 
 - Verify the server URL is correct and accessible

package/dist/index.js

@@ -40,9 +40,10 @@ function getPlatformPaths() {
 var { appSupport, vscodePath } = getPlatformPaths();
 function transformGooseConfig(serverName, config) {
   if (config.url) {
+    const gooseType = config.type === "sse" ? "sse" : "streamable_http";
     return {
       name: serverName,
-      type: "streamable_http",
+      type: gooseType,
       url: config.url,
       enabled: true,
       timeout: 300
@@ -139,8 +140,8 @@ var agents = {
       process.env.CODEX_HOME || join(home, ".codex"),
       "config.toml"
     ),
-    projectDetectPaths: [],
-    // Global only - no project support
+    localConfigPath: ".codex/config.toml",
+    projectDetectPaths: [".codex"],
     configKey: "mcp_servers",
     format: "toml",
     supportedTransports: ["stdio", "http", "sse"],
@@ -183,8 +184,7 @@ var agents = {
     projectDetectPaths: [".goose"],
     configKey: "extensions",
     format: "yaml",
-    supportedTransports: ["stdio", "http"],
-    // Goose does not support SSE
+    supportedTransports: ["stdio", "http", "sse"],
     detectGlobalInstall: async () => {
       return existsSync(join(home, ".config", "goose"));
     },
@@ -220,18 +220,15 @@ var agents = {
   zed: {
     name: "zed",
     displayName: "Zed",
-    configPath: process.platform === "win32" ? join(
-      process.env.APPDATA || join(home, "AppData", "Roaming"),
-      "Zed",
-      "settings.json"
-    ) : join(home, ".config", "zed", "settings.json"),
-    projectDetectPaths: [],
-    // Global only - no project support
+    configPath: process.platform === "darwin" || process.platform === "win32" ? join(appSupport, "Zed", "settings.json") : join(appSupport, "zed", "settings.json"),
+    localConfigPath: ".zed/settings.json",
+    projectDetectPaths: [".zed"],
     configKey: "context_servers",
     format: "json",
     supportedTransports: ["stdio", "http", "sse"],
     detectGlobalInstall: async () => {
-      return existsSync(join(home, ".config", "zed")) || existsSync(join(process.env.APPDATA || "", "Zed"));
+      const configDir = process.platform === "darwin" || process.platform === "win32" ? join(appSupport, "Zed") : join(appSupport, "zed");
+      return existsSync(configDir);
     },
     transformConfig: transformZedConfig
   }
@@ -410,6 +407,38 @@ import { join as join2, dirname as dirname4 } from "path";
 import { readFileSync, writeFileSync, existsSync as existsSync2, mkdirSync } from "fs";
 import { dirname } from "path";
 import * as jsonc from "jsonc-parser";
+
+// src/formats/utils.ts
+function deepMerge(target, source) {
+  const result = { ...target };
+  for (const key in source) {
+    const sourceValue = source[key];
+    const targetValue = result[key];
+    if (sourceValue && typeof sourceValue === "object" && !Array.isArray(sourceValue)) {
+      result[key] = deepMerge(
+        targetValue && typeof targetValue === "object" ? targetValue : {},
+        sourceValue
+      );
+    } else {
+      result[key] = sourceValue;
+    }
+  }
+  return result;
+}
+function getNestedValue(obj, path) {
+  const keys = path.split(".");
+  let current = obj;
+  for (const key of keys) {
+    if (current && typeof current === "object" && key in current) {
+      current = current[key];
+    } else {
+      return void 0;
+    }
+  }
+  return current;
+}
+
+// src/formats/json.ts
 function detectIndent(text) {
   let result = null;
   jsonc.visit(text, {
@@ -453,34 +482,6 @@ function writeJsonConfig(filePath, config, configKey) {
   }
   writeFileSync(filePath, JSON.stringify(mergedConfig, null, 2));
 }
-function deepMerge(target, source) {
-  const result = { ...target };
-  for (const key in source) {
-    const sourceValue = source[key];
-    const targetValue = result[key];
-    if (sourceValue && typeof sourceValue === "object" && !Array.isArray(sourceValue)) {
-      result[key] = deepMerge(
-        targetValue && typeof targetValue === "object" ? targetValue : {},
-        sourceValue
-      );
-    } else {
-      result[key] = sourceValue;
-    }
-  }
-  return result;
-}
-function getNestedValue(obj, path) {
-  const keys = path.split(".");
-  let current = obj;
-  for (const key of keys) {
-    if (current && typeof current === "object" && key in current) {
-      current = current[key];
-    } else {
-      return void 0;
-    }
-  }
-  return current;
-}
 function setNestedValue(obj, path, value) {
   const keys = path.split(".");
   const lastKey = keys.pop();
@@ -516,7 +517,7 @@ function writeYamlConfig(filePath, config) {
   if (existsSync3(filePath)) {
     existingConfig = readYamlConfig(filePath);
   }
-  const mergedConfig = deepMerge2(existingConfig, config);
+  const mergedConfig = deepMerge(existingConfig, config);
   const content = yaml.dump(mergedConfig, {
     indent: 2,
     lineWidth: -1,
@@ -524,22 +525,6 @@ function writeYamlConfig(filePath, config) {
   });
   writeFileSync2(filePath, content);
 }
-function deepMerge2(target, source) {
-  const result = { ...target };
-  for (const key in source) {
-    const sourceValue = source[key];
-    const targetValue = result[key];
-    if (sourceValue && typeof sourceValue === "object" && !Array.isArray(sourceValue)) {
-      result[key] = deepMerge2(
-        targetValue && typeof targetValue === "object" ? targetValue : {},
-        sourceValue
-      );
-    } else {
-      result[key] = sourceValue;
-    }
-  }
-  return result;
-}
 
 // src/formats/toml.ts
 import { readFileSync as readFileSync3, writeFileSync as writeFileSync3, existsSync as existsSync4, mkdirSync as mkdirSync3 } from "fs";
@@ -562,26 +547,10 @@ function writeTomlConfig(filePath, config) {
   if (existsSync4(filePath)) {
     existingConfig = readTomlConfig(filePath);
   }
-  const mergedConfig = deepMerge3(existingConfig, config);
+  const mergedConfig = deepMerge(existingConfig, config);
   const content = TOML.stringify(mergedConfig);
   writeFileSync3(filePath, content);
 }
-function deepMerge3(target, source) {
-  const result = { ...target };
-  for (const key in source) {
-    const sourceValue = source[key];
-    const targetValue = result[key];
-    if (sourceValue && typeof sourceValue === "object" && !Array.isArray(sourceValue)) {
-      result[key] = deepMerge3(
-        targetValue && typeof targetValue === "object" ? targetValue : {},
-        sourceValue
-      );
-    } else {
-      result[key] = sourceValue;
-    }
-  }
-  return result;
-}
 
 // src/formats/index.ts
 function writeConfig(filePath, config, format, configKey) {
@@ -685,7 +654,7 @@ function installServer(serverName, serverConfig, agentTypes, options = {}) {
 // package.json
 var package_default = {
   name: "add-mcp",
-  version: "0.3.4",
+  version: "0.4.0",
   description: "Add MCP servers to your favorite coding agents with a single command.",
   author: "Andre Landgraf <andre@neon.tech>",
   license: "Apache-2.0",

package/package.json

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