add-mcp 0.3.2 → 0.3.5

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,26 +59,17 @@ npx add-mcp "node /path/to/server.js --port 3000"
 | `-y, --yes`              | Skip all confirmation prompts                                            |
 | `--all`                  | Install to all 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
+### Additional Commands
 
-# Non-interactive installation (CI/CD friendly)
-npx add-mcp https://mcp.example.com/mcp -g -a claude-code -y
+Besides the implicit add command, `add-mcp` also supports the following commands:
 
-# Install to all agents
-npx add-mcp mcp-server-github --all
+| Command       | Description                                                  |
+| ------------- | ------------------------------------------------------------ |
+| `list-agents` | List all supported coding agents with scope (project/global) |
 
-# Install to all agents, globally, without prompts
-npx add-mcp mcp-server-github --all -g -y
+```bash
+# List all supported agents
+npx add-mcp list-agents
 ```
 
 ### Installation Scope
@@ -92,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.
 
@@ -121,37 +130,17 @@ MCP servers can be installed to any of these agents:
 
 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
@@ -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"));
     },
@@ -296,11 +296,41 @@ function isPackageName(input) {
   }
   return false;
 }
+var commonTlds = /* @__PURE__ */ new Set([
+  "com",
+  "org",
+  "net",
+  "io",
+  "dev",
+  "ai",
+  "tech",
+  "co",
+  "app",
+  "cloud",
+  "sh",
+  "run"
+]);
+function extractBrandFromHostname(hostname) {
+  const parts = hostname.split(".");
+  const meaningfulParts = parts.filter((part) => {
+    const lower = part.toLowerCase();
+    if (commonTlds.has(lower)) return false;
+    if (lower === "mcp" || lower === "api" || lower === "www") return false;
+    return true;
+  });
+  if (meaningfulParts.length > 0) {
+    return meaningfulParts[0];
+  }
+  if (parts.length >= 2) {
+    return parts[parts.length - 2];
+  }
+  return "mcp-server";
+}
 function inferName(input, type) {
   if (type === "remote") {
     try {
       const url = new URL(input);
-      return url.hostname.replace(/\./g, "-");
+      return extractBrandFromHostname(url.hostname);
     } catch {
       return "mcp-server";
     }
@@ -380,6 +410,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, {
@@ -423,34 +485,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();
@@ -486,7 +520,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,
@@ -494,22 +528,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";
@@ -532,26 +550,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) {
@@ -655,7 +657,7 @@ function installServer(serverName, serverConfig, agentTypes, options = {}) {
 // package.json
 var package_default = {
   name: "add-mcp",
-  version: "0.3.2",
+  version: "0.3.5",
   description: "Add MCP servers to your favorite coding agents with a single command.",
   author: "Andre Landgraf <andre@neon.tech>",
   license: "Apache-2.0",
@@ -782,7 +784,26 @@ program.name("add-mcp").description(
 ).option("--type <type>", "Alias for --transport").option("-y, --yes", "Skip confirmation prompts").option("--all", "Install to all agents").action(async (target, options) => {
   await main(target, options);
 });
+program.command("list-agents").description("List all supported coding agents").action(() => {
+  listAgents();
+});
 program.parse();
+function listAgents() {
+  showLogo();
+  console.log();
+  console.log(`${DIM}Supported agents:${RESET}`);
+  console.log();
+  const allAgentTypes = getAgentTypes();
+  for (const agentType of allAgentTypes) {
+    const agent = agents[agentType];
+    const hasProjectSupport = supportsProjectConfig(agentType);
+    const scope = hasProjectSupport ? "project, global" : "global";
+    console.log(
+      `  ${TEXT}${agent.displayName}${RESET} ${DIM}(${scope})${RESET}`
+    );
+  }
+  console.log();
+}
 async function main(target, options) {
   showLogo();
   if (!target) {

package/package.json

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