add-mcp 1.9.1 → 1.10.2

package/dist/lib.d.ts

@@ -0,0 +1,102 @@
+type AgentType = "antigravity" | "cline" | "cline-cli" | "claude-code" | "claude-desktop" | "codex" | "cursor" | "gemini-cli" | "goose" | "github-copilot-cli" | "mcporter" | "opencode" | "vscode" | "zed";
+type ConfigFormat = "json" | "yaml" | "toml";
+interface AgentConfig {
+    /** Internal name */
+    name: string;
+    /** Display name for UI */
+    displayName: string;
+    /** Global config file path */
+    configPath: string;
+    /** Local (project-level) config file path, if supported */
+    localConfigPath?: string;
+    /** Paths to check for project-level detection (relative to cwd) */
+    projectDetectPaths: string[];
+    /** Key in config file where MCP servers are stored (supports dot notation) */
+    configKey: string;
+    /** Optional key for project-level config when different from global configKey */
+    localConfigKey?: string;
+    /** Config file format */
+    format: ConfigFormat;
+    /** Supported transport types for this agent */
+    supportedTransports: ("stdio" | "sse" | "http")[];
+    /** Shown when a user tries to use an unsupported transport */
+    unsupportedTransportMessage?: string;
+    /** Function to detect if agent is installed globally */
+    detectGlobalInstall: () => Promise<boolean>;
+    /** Optional function to dynamically resolve config path */
+    resolveConfigPath?: (agent: AgentConfig, options: {
+        local: boolean;
+        cwd: string;
+    }) => string;
+    /** Optional function to transform server config to agent-specific format */
+    transformConfig?: (serverName: string, config: McpServerConfig, context?: {
+        local: boolean;
+    }) => unknown;
+}
+type TransportType = "sse" | "http";
+interface McpServerConfig {
+    /** For remote servers */
+    type?: TransportType;
+    url?: string;
+    headers?: Record<string, string>;
+    /** For local stdio servers */
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+
+interface InstallOptions {
+    /** Install to local (project-level) config instead of global */
+    local?: boolean;
+    /** Current working directory for local installs */
+    cwd?: string;
+}
+interface InstallResult {
+    success: boolean;
+    path: string;
+    error?: string;
+}
+
+declare const agents: Record<AgentType, AgentConfig>;
+declare function getAgentTypes(): AgentType[];
+declare function detectProjectAgents(cwd?: string): AgentType[];
+declare function detectGlobalAgents(): Promise<AgentType[]>;
+
+interface InstalledServer {
+    serverName: string;
+    config: Record<string, unknown>;
+    identity: string;
+    agentType: AgentType;
+    scope: "local" | "global";
+    configPath: string;
+}
+interface AgentServers {
+    agentType: AgentType;
+    displayName: string;
+    detected: boolean;
+    scope: "local" | "global";
+    configPath: string;
+    servers: InstalledServer[];
+}
+/**
+ * Gather installed servers across detected (or explicitly specified) agents.
+ * When `agents` is provided, those agents are included even if not detected
+ * (with detected=false).
+ */
+declare function listInstalledServers(options: {
+    global?: boolean;
+    agents?: AgentType[];
+    cwd?: string;
+}): Promise<AgentServers[]>;
+
+type AgentInput = AgentType | (string & {});
+declare function upsertServer(agentType: AgentInput, serverName: string, serverConfig: McpServerConfig, options?: InstallOptions): InstallResult;
+interface RemoveServerResult {
+    success: boolean;
+    path: string;
+    removed: boolean;
+    error?: string;
+}
+declare function removeServer(agentType: AgentInput, serverName: string, options?: InstallOptions): RemoveServerResult;
+
+export { type AgentConfig, type AgentInput, type AgentServers, type AgentType, type InstallOptions, type InstallResult, type InstalledServer, type McpServerConfig, type RemoveServerResult, agents, detectGlobalAgents, detectProjectAgents, getAgentTypes, listInstalledServers, removeServer, upsertServer };

package/dist/lib.js

@@ -0,0 +1,79 @@
+import {
+  agents,
+  detectGlobalAgents,
+  detectProjectAgents,
+  getAgentTypes,
+  getConfigKey,
+  getConfigPath2 as getConfigPath,
+  getNestedValue,
+  installServerForAgent,
+  listInstalledServers,
+  readConfig,
+  removeServerFromConfig
+} from "./chunk-B27GVIBZ.js";
+
+// src/lib.ts
+import { existsSync } from "fs";
+function isKnownAgent(agentType) {
+  return Object.prototype.hasOwnProperty.call(agents, agentType);
+}
+function validate(agentType, local) {
+  if (!isKnownAgent(agentType)) {
+    return `Unknown agent type: ${String(agentType)}`;
+  }
+  if (local && !agents[agentType].localConfigPath) {
+    return `${agentType} does not support project-level config`;
+  }
+  return null;
+}
+function upsertServer(agentType, serverName, serverConfig, options = {}) {
+  const error = validate(agentType, options.local);
+  if (error) return { success: false, path: "", error };
+  return installServerForAgent(
+    serverName,
+    serverConfig,
+    agentType,
+    options
+  );
+}
+function hasServer(serversObj, serverName) {
+  return !!serversObj && typeof serversObj === "object" && !Array.isArray(serversObj) && Object.prototype.hasOwnProperty.call(serversObj, serverName);
+}
+function doRemove(agentType, serverName, options) {
+  const agent = agents[agentType];
+  const configPath = getConfigPath(agent, options);
+  const configKey = getConfigKey(agent, options);
+  if (!existsSync(configPath)) {
+    return { success: true, path: configPath, removed: false };
+  }
+  const fullConfig = readConfig(configPath, agent.format);
+  if (!hasServer(getNestedValue(fullConfig, configKey), serverName)) {
+    return { success: true, path: configPath, removed: false };
+  }
+  removeServerFromConfig(configPath, agent.format, configKey, serverName);
+  return { success: true, path: configPath, removed: true };
+}
+function removeServer(agentType, serverName, options = {}) {
+  const error = validate(agentType, options.local);
+  if (error) return { success: false, path: "", removed: false, error };
+  const known = agentType;
+  try {
+    return doRemove(known, serverName, options);
+  } catch (e) {
+    return {
+      success: false,
+      path: getConfigPath(agents[known], options),
+      removed: false,
+      error: e instanceof Error ? e.message : "Unknown error"
+    };
+  }
+}
+export {
+  agents,
+  detectGlobalAgents,
+  detectProjectAgents,
+  getAgentTypes,
+  listInstalledServers,
+  removeServer,
+  upsertServer
+};

package/package.json

@@ -1,10 +1,19 @@
 {
   "name": "add-mcp",
-  "version": "1.9.1",
+  "version": "1.10.2",
   "description": "Add MCP servers to your favorite coding agents with a single command.",
   "author": "Andre Landgraf <andre@neon.tech>",
   "license": "Apache-2.0",
   "type": "module",
+  "main": "./dist/lib.js",
+  "types": "./dist/lib.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/lib.d.ts",
+      "import": "./dist/lib.js"
+    },
+    "./package.json": "./package.json"
+  },
   "bin": {
     "add-mcp": "dist/index.js"
   },
@@ -14,10 +23,10 @@
   ],
   "scripts": {
     "fmt": "prettier --write .",
-    "build": "tsup src/index.ts --format esm --dts --clean",
+    "build": "tsup src/index.ts src/lib.ts --format esm --dts --clean",
     "dev": "tsx src/index.ts",
-    "test": "tsx tests/source-parser.test.ts && tsx tests/agents.test.ts && tsx tests/config.test.ts && tsx tests/installer.test.ts && tsx tests/find.test.ts && tsx tests/package-arguments.test.ts && tsx tests/template.test.ts && tsx tests/reader.test.ts && tsx tests/formats-remove.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/config.test.ts && tsx tests/installer.test.ts && tsx tests/find.test.ts && tsx tests/package-arguments.test.ts && tsx tests/template.test.ts && tsx tests/reader.test.ts && tsx tests/formats-remove.test.ts",
+    "test": "tsx tests/source-parser.test.ts && tsx tests/agents.test.ts && tsx tests/config.test.ts && tsx tests/installer.test.ts && tsx tests/find.test.ts && tsx tests/package-arguments.test.ts && tsx tests/template.test.ts && tsx tests/reader.test.ts && tsx tests/formats-remove.test.ts && tsx tests/lib.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/config.test.ts && tsx tests/installer.test.ts && tsx tests/find.test.ts && tsx tests/package-arguments.test.ts && tsx tests/template.test.ts && tsx tests/reader.test.ts && tsx tests/formats-remove.test.ts && tsx tests/lib.test.ts",
     "registry:sort": "tsx scripts/sort-registry.ts",
     "registry:verify": "tsx scripts/verify-registry.ts",
     "test:e2e": "tsx tests/e2e/install.test.ts && tsx tests/e2e/cli.test.ts",