mcpman 0.3.0 → 0.6.0

package/README.md

@@ -39,6 +39,12 @@ mcpman install @modelcontextprotocol/server-filesystem
 - **Config sync** — keep server configs consistent across all your AI clients; `--remove` cleans extras
 - **Security audit** — scan servers for vulnerabilities with trust scoring; `--fix` auto-updates vulnerable packages
 - **Auto-update** — get notified when server updates are available
+- **Plugin system** — extend mcpman with npm-based plugins for custom registries (e.g. Ollama, HuggingFace)
+- **Export/Import** — portable JSON bundles for full config migration across machines
+- **Server testing** — validate MCP servers respond to JSON-RPC initialize + tools/list
+- **Log streaming** — stream stdout/stderr from servers in real time
+- **Profiles** — save/restore named server configurations for quick switching
+- **Self-upgrade** — update mcpman itself with a single command
 - **Interactive prompts** — guided installation with env var configuration
 - **No extra daemon** — pure CLI, works anywhere Node ≥ 20 runs
 
@@ -153,6 +159,130 @@ mcpman update my-server  # update specific server
 mcpman update --check    # check only, don't apply
 ```
 
+### `config <set|get|list|reset>`
+
+Manage persistent CLI configuration at `~/.mcpman/config.json`.
+
+```sh
+mcpman config set defaultClient cursor
+mcpman config get defaultClient
+mcpman config list
+mcpman config reset
+```
+
+Keys: `defaultClient`, `updateCheckInterval`, `preferredRegistry`, `vaultTimeout`, `plugins`.
+
+### `search <query>`
+
+Search for MCP servers on npm or Smithery registry.
+
+```sh
+mcpman search filesystem
+mcpman search brave --registry smithery
+mcpman search tools --all        # include plugin registries
+mcpman search tools --limit 10
+```
+
+**Options:**
+- `--registry <npm|smithery>` — registry to search (default: npm)
+- `--limit <n>` — max results (default: 20, max: 100)
+- `--all` — include plugin registries in results
+
+### `info <server>`
+
+Show detailed information about an MCP server package.
+
+```sh
+mcpman info @modelcontextprotocol/server-filesystem
+mcpman info my-server --json
+```
+
+### `run <server>`
+
+Launch an MCP server with vault secrets auto-injected into the process environment.
+
+```sh
+mcpman run my-server
+mcpman run my-server --env API_KEY=sk-...
+```
+
+### `upgrade`
+
+Upgrade mcpman itself to the latest version from npm.
+
+```sh
+mcpman upgrade           # check and install latest
+mcpman upgrade --check   # only check, don't install
+```
+
+### `test [server]`
+
+Validate MCP server connectivity by sending JSON-RPC `initialize` + `tools/list`.
+
+```sh
+mcpman test my-server    # test a specific server
+mcpman test --all        # test all installed servers
+```
+
+Reports pass/fail, response time, and discovered tools for each server.
+
+### `logs <server>`
+
+Stream stdout/stderr from an MCP server process in real time.
+
+```sh
+mcpman logs my-server    # stream logs (Ctrl+C to stop)
+```
+
+Vault secrets are auto-injected into the server environment.
+
+### `profiles <create|switch|list|delete>`
+
+Manage named server configuration profiles for quick switching.
+
+```sh
+mcpman profiles create dev           # snapshot current servers as "dev"
+mcpman profiles create prod -d "Production config"
+mcpman profiles list                 # show all profiles
+mcpman profiles switch dev           # apply "dev" profile to lockfile
+mcpman profiles delete old           # remove a profile
+```
+
+After switching, run `mcpman sync` to apply the profile to all clients.
+
+### `plugin <add|remove|list>`
+
+Manage mcpman plugins for custom registries.
+
+```sh
+mcpman plugin add mcpman-plugin-ollama    # install plugin
+mcpman plugin remove mcpman-plugin-ollama # uninstall plugin
+mcpman plugin list                        # show installed plugins
+```
+
+Plugins are npm packages that export a `McpmanPlugin` interface with `name`, `prefix`, and `resolve()`. Once installed, their prefix (e.g. `ollama:`) works with `mcpman install ollama:my-model`.
+
+### `export [output-file]`
+
+Export mcpman config, lockfile, vault, and plugins to a portable JSON file.
+
+```sh
+mcpman export                    # default: mcpman-export.json
+mcpman export backup.json
+mcpman export --no-vault         # exclude encrypted vault
+mcpman export --no-plugins       # exclude plugin list
+```
+
+### `import <file>`
+
+Restore mcpman config, lockfile, vault, and plugins from an export bundle.
+
+```sh
+mcpman import mcpman-export.json
+mcpman import backup.json --yes       # skip confirmation
+mcpman import backup.json --dry-run   # preview without applying
+```
+
 ---
 
 ## Comparison
@@ -168,6 +298,12 @@ mcpman update --check    # check only, don't apply
 | CI/CD | GitHub Actions | None | None |
 | Auto-update | Version check + notify | None | None |
 | Registry sources | npm + Smithery + GitHub | Smithery only | npm only |
+| Plugin system | npm-based custom registries | None | None |
+| Export/Import | Full config portability | None | None |
+| Server testing | JSON-RPC validation | None | None |
+| Log streaming | Real-time stdout/stderr | None | None |
+| Profiles | Named config switching | None | None |
+| Self-upgrade | Built-in CLI updater | None | None |
 | Interactive setup | Yes | Partial | No |
 | Project-scoped | Yes (`init`) | No | No |
 

package/dist/{chunk-QY22QTBR.js → chunk-NS6HV723.js}

@@ -1,8 +1,64 @@
 #!/usr/bin/env node
 
+// src/utils/paths.ts
+import os from "os";
+import path from "path";
+function getHomedir() {
+  return os.homedir();
+}
+function getMcpmanDir() {
+  return path.join(os.homedir(), ".mcpman");
+}
+function getConfigPath() {
+  return path.join(getMcpmanDir(), "config.json");
+}
+function getPluginDir() {
+  return path.join(getMcpmanDir(), "plugins");
+}
+function getProfilesDir() {
+  return path.join(getMcpmanDir(), "profiles");
+}
+function getAppDataDir() {
+  const home = getHomedir();
+  if (process.platform === "darwin") {
+    return path.join(home, "Library", "Application Support");
+  }
+  if (process.platform === "win32") {
+    return process.env.APPDATA ?? path.join(home, "AppData", "Roaming");
+  }
+  return process.env.XDG_CONFIG_HOME ?? path.join(home, ".config");
+}
+function resolveConfigPath(client) {
+  const appData = getAppDataDir();
+  const home = getHomedir();
+  switch (client) {
+    case "claude-desktop":
+      return path.join(appData, "Claude", "claude_desktop_config.json");
+    case "cursor":
+      return path.join(appData, "Cursor", "User", "globalStorage", "cursor.mcp", "mcp.json");
+    case "windsurf":
+      return path.join(
+        appData,
+        "Windsurf",
+        "User",
+        "globalStorage",
+        "windsurf.mcpConfigJson",
+        "mcp.json"
+      );
+    case "vscode":
+      if (process.platform === "darwin") {
+        return path.join(appData, "Code", "User", "settings.json");
+      }
+      if (process.platform === "win32") {
+        return path.join(appData, "Code", "User", "settings.json");
+      }
+      return path.join(home, ".config", "Code", "User", "settings.json");
+  }
+}
+
 // src/clients/base-client-handler.ts
 import fs from "fs";
-import path from "path";
+import path2 from "path";
 
 // src/clients/types.ts
 var ConfigParseError = class extends Error {
@@ -24,7 +80,7 @@ var ConfigWriteError = class extends Error {
 async function atomicWrite(filePath, content) {
   const tmpPath = `${filePath}.tmp`;
   try {
-    await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.promises.mkdir(path2.dirname(filePath), { recursive: true });
     await fs.promises.writeFile(tmpPath, content, { encoding: "utf-8", mode: 384 });
     await fs.promises.rename(tmpPath, filePath);
   } catch (err) {
@@ -45,7 +101,7 @@ async function pathExists(p) {
 }
 var BaseClientHandler = class {
   async isInstalled() {
-    const dir = path.dirname(this.getConfigPath());
+    const dir = path2.dirname(this.getConfigPath());
     return pathExists(dir);
   }
   /** Read raw JSON from disk, return empty object if file missing */
@@ -99,57 +155,6 @@ var BaseClientHandler = class {
   }
 };
 
-// src/utils/paths.ts
-import os from "os";
-import path2 from "path";
-function getHomedir() {
-  return os.homedir();
-}
-function getAppDataDir() {
-  const home = getHomedir();
-  if (process.platform === "darwin") {
-    return path2.join(home, "Library", "Application Support");
-  }
-  if (process.platform === "win32") {
-    return process.env.APPDATA ?? path2.join(home, "AppData", "Roaming");
-  }
-  return process.env.XDG_CONFIG_HOME ?? path2.join(home, ".config");
-}
-function resolveConfigPath(client) {
-  const appData = getAppDataDir();
-  const home = getHomedir();
-  switch (client) {
-    case "claude-desktop":
-      return path2.join(appData, "Claude", "claude_desktop_config.json");
-    case "cursor":
-      return path2.join(
-        appData,
-        "Cursor",
-        "User",
-        "globalStorage",
-        "cursor.mcp",
-        "mcp.json"
-      );
-    case "windsurf":
-      return path2.join(
-        appData,
-        "Windsurf",
-        "User",
-        "globalStorage",
-        "windsurf.mcpConfigJson",
-        "mcp.json"
-      );
-    case "vscode":
-      if (process.platform === "darwin") {
-        return path2.join(appData, "Code", "User", "settings.json");
-      }
-      if (process.platform === "win32") {
-        return path2.join(appData, "Code", "User", "settings.json");
-      }
-      return path2.join(home, ".config", "Code", "User", "settings.json");
-  }
-}
-
 // src/clients/claude-desktop.ts
 var ClaudeDesktopHandler = class extends BaseClientHandler {
   type = "claude-desktop";
@@ -223,6 +228,9 @@ async function getInstalledClients() {
 }
 
 export {
+  getConfigPath,
+  getPluginDir,
+  getProfilesDir,
   getAllClientTypes,
   getClient,
   getInstalledClients

package/dist/{trust-scorer-LYC6KZCD.js → chunk-RGKHLY5G.js}

@@ -72,6 +72,7 @@ function computeTrustScore(metadata, vulns) {
   const score = Math.min(100, Math.max(0, Math.round(weighted)));
   return { score, riskLevel: toRiskLevel(score) };
 }
+
 export {
   computeTrustScore
 };

package/dist/{client-detector-SUIJSIYM.js → client-detector-CY7WPF3K.js}

@@ -3,7 +3,7 @@ import {
   getAllClientTypes,
   getClient,
   getInstalledClients
-} from "./chunk-QY22QTBR.js";
+} from "./chunk-NS6HV723.js";
 export {
   getAllClientTypes,
   getClient,