@global-packages/mcp-kit 1.0.0

package/README.md

@@ -0,0 +1,97 @@
+# @global-packages/mcp-kit
+
+> Zero-friction MCP setup for VS Code — works on Windows, macOS and Linux
+
+## Install
+
+npm install -g @global-packages/mcp-kit
+
+## Quick Start
+
+mcp-kit install
+mcp-kit init --dev # for developers
+mcp-kit init --non-dev # for non-developers
+
+## What It Does
+
+- Auto-detects your .vscode folder across project and OS paths
+- Configures Azure, Confluence, MSSQL, Playwright, ADO and more
+- Stores credentials in your system keychain, .env, or inline
+- Works for developers and non-technical employees alike
+
+## All Commands
+
+| Command | Description |
+|---------|-------------|
+| mcp-kit install | Pre-download all MCP packages |
+| mcp-kit init --dev | Configure developer MCPs |
+| mcp-kit init --non-dev | Configure non-developer MCPs |
+| mcp-kit status | Show configured MCPs |
+| mcp-kit add <id> | Add a single MCP |
+| mcp-kit remove <id> | Remove an MCP |
+| mcp-kit update | Update to latest versions |
+| mcp-kit doctor | Diagnose all issues |
+| mcp-kit list | List configured MCPs |
+| mcp-kit list --available | List all available MCPs |
+| mcp-kit reset | Wipe all configuration |
+| mcp-kit export | Export config for teammates |
+| mcp-kit import <file> | Import shared config |
+
+## Supported MCPs
+
+| ID | Name | For | Category |
+|----|------|-----|----------|
+| azure | Azure MCP | all | cloud |
+| confluence | Confluence MCP | all | documentation |
+| mssql | MSSQL MCP | dev | database |
+| playwright | Playwright MCP | dev | testing |
+| runbook | Runbook MCP | all | incident |
+| filesystem | Filesystem MCP | dev | filesystem |
+| git | Git MCP | dev | versioncontrol |
+| azuredevops | Azure DevOps MCP | all | devops |
+| postgres | PostgreSQL MCP | dev | database |
+| slack | Slack MCP | all | productivity |
+
+## .vscode Detection Logic
+
+mcp-kit resolves the target path in this order:
+
+1. Walks up parent directories from current working directory looking for `.vscode`.
+2. Falls back to global VS Code User path for your OS.
+3. Creates `.vscode` in the current working directory if none exists.
+
+OS global config paths:
+
+- Windows: `%APPDATA%\\Code\\User`
+- macOS: `~/Library/Application Support/Code/User`
+- Linux: `~/.config/Code/User`
+
+## Credential Storage
+
+mcp-kit supports 3 secure storage strategies:
+
+1. `keychain` (recommended): Uses system keychain / credential manager.
+2. `dotenv`: Writes values into `.env` and references `${env:KEY}` in `mcp.json`.
+3. `inline`: Writes raw values directly into `mcp.json` (not recommended for shared repos).
+
+For shared repositories, keychain is strongly recommended.
+
+## Adding to Registry
+
+The MCP extension point is `src/constants.ts`.
+
+To add a new MCP:
+
+1. Add one `McpDefinition` object to `MCP_REGISTRY`.
+2. Add the MCP id to `DEV_MCP_IDS` or `NON_DEV_MCP_IDS`.
+
+All commands and prompts read dynamically from these constants.
+
+## Publishing
+
+npm login
+npm version patch
+npm run build
+npm publish --access public
+
+## License: MIT

package/dist/commands/add.d.ts

@@ -0,0 +1,2 @@
+export declare function runAdd(mcpId: string): Promise<void>;
+//# sourceMappingURL=add.d.ts.map

package/dist/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAUA,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkFzD"}

package/dist/commands/add.js

@@ -0,0 +1,89 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAdd = runAdd;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const constants_1 = require("../constants");
+const detector_1 = require("../core/detector");
+const credentials_1 = require("../core/credentials");
+const registry_1 = require("../core/registry");
+const writer_1 = require("../core/writer");
+const shared_prompts_1 = require("../prompts/shared-prompts");
+const logger_1 = require("../utils/logger");
+async function runAdd(mcpId) {
+    try {
+        const mcp = (0, registry_1.getMcpById)(mcpId);
+        if (!mcp) {
+            logger_1.log.error(`Unknown MCP: ${mcpId}`);
+            logger_1.log.info("Run `mcp-kit list --available` to see valid MCP IDs.");
+            process.exit(1);
+        }
+        const detected = await (0, detector_1.detectVsCodePath)();
+        const config = await (0, writer_1.readMcpJson)(detected.mcpJsonPath);
+        if (config.servers[mcpId]) {
+            logger_1.log.warn(`MCP ${mcpId} is already configured. Reconfiguring...`);
+        }
+        const storage = await (0, shared_prompts_1.askCredentialStorage)();
+        const answers = {};
+        for (const envVar of mcp.envVars) {
+            const response = await inquirer_1.default.prompt([
+                {
+                    type: envVar.secret ? "password" : "input",
+                    name: "value",
+                    message: `${envVar.label}${envVar.required ? " *" : " (optional)"}`,
+                    mask: envVar.secret ? "*" : undefined,
+                    validate: (input) => !envVar.required || input.length > 0 || "This field is required"
+                }
+            ]);
+            answers[envVar.key] = response.value;
+            if (envVar.secret && response.value) {
+                await (0, credentials_1.storeCredential)(envVar.key, response.value, storage);
+            }
+        }
+        const args = mcp.id === "filesystem" && answers.FILESYSTEM_ALLOWED_PATH
+            ? [...mcp.args, answers.FILESYSTEM_ALLOWED_PATH]
+            : [...mcp.args];
+        const env = {};
+        for (const envVar of mcp.envVars) {
+            const value = answers[envVar.key];
+            if (!value && !envVar.required) {
+                continue;
+            }
+            env[envVar.key] = (0, credentials_1.buildEnvRefValue)(envVar.key, storage, value);
+        }
+        await (0, writer_1.addServerToMcpJson)(detected.mcpJsonPath, mcp.id, {
+            command: mcp.command,
+            args,
+            env
+        });
+        const meta = (await fs_extra_1.default.pathExists(constants_1.MCP_KIT_META_PATH))
+            ? await fs_extra_1.default.readJSON(constants_1.MCP_KIT_META_PATH)
+            : {
+                installedAt: new Date().toISOString(),
+                mcpKitVersion: require("../../package.json").version,
+                installedMcps: []
+            };
+        meta.lastUpdated = new Date().toISOString();
+        meta.credentialStorage = storage;
+        meta.vscodePath = detected.vscodeFolderPath;
+        meta.installedMcps = Array.from(new Set([...(meta.installedMcps || []), mcp.id]));
+        await fs_extra_1.default.mkdirp(require("node:path").dirname(constants_1.MCP_KIT_META_PATH));
+        await fs_extra_1.default.writeJSON(constants_1.MCP_KIT_META_PATH, meta, { spaces: 2 });
+        logger_1.log.success(`Added ${mcp.name} to ${detected.mcpJsonPath}`);
+        logger_1.log.info("Reload VS Code to activate");
+        process.exit(0);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : "Unknown error";
+        logger_1.log.error(`Add failed: ${message}`);
+        logger_1.log.muted("Suggestion: run `mcp-kit doctor` after fixing input values.");
+        if (process.env.DEBUG && err instanceof Error) {
+            console.error(err.stack);
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":";;;;;AAUA,wBAkFC;AA5FD,wDAA0B;AAC1B,wDAAgC;AAChC,4CAAiD;AACjD,+CAAoD;AACpD,qDAAwE;AACxE,+CAA8C;AAC9C,2CAAiE;AACjE,8DAAiE;AACjE,4CAAsC;AAE/B,KAAK,UAAU,MAAM,CAAC,KAAa;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,qBAAU,EAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,YAAG,CAAC,KAAK,CAAC,gBAAgB,KAAK,EAAE,CAAC,CAAC;YACnC,YAAG,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;YACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAA,2BAAgB,GAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,IAAA,oBAAW,EAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACvD,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,YAAG,CAAC,IAAI,CAAC,OAAO,KAAK,0CAA0C,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAA,qCAAoB,GAAE,CAAC;QAC7C,MAAM,OAAO,GAA2B,EAAE,CAAC;QAE3C,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,MAAM,kBAAQ,CAAC,MAAM,CAAoB;gBACxD;oBACE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO;oBAC1C,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,EAAE;oBACnE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;oBACrC,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,wBAAwB;iBAC9F;aACF,CAAC,CAAC;YACH,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;YAErC,IAAI,MAAM,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACpC,MAAM,IAAA,6BAAe,EAAC,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,GAAG,CAAC,EAAE,KAAK,YAAY,IAAI,OAAO,CAAC,uBAAuB;YACrE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,uBAAuB,CAAC;YAChD,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QAElB,MAAM,GAAG,GAA2B,EAAE,CAAC;QACvC,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAC/B,SAAS;YACX,CAAC;YACD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAA,8BAAgB,EAAC,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,IAAA,2BAAkB,EAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,EAAE;YACrD,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,IAAI;YACJ,GAAG;SACJ,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,CAAC,MAAM,kBAAE,CAAC,UAAU,CAAC,6BAAiB,CAAC,CAAC;YACnD,CAAC,CAAC,MAAM,kBAAE,CAAC,QAAQ,CAAC,6BAAiB,CAAC;YACtC,CAAC,CAAC;gBACE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACrC,aAAa,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC,OAAO;gBACpD,aAAa,EAAE,EAAE;aAClB,CAAC;QAEN,IAAI,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC5C,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,gBAAgB,CAAC;QAC5C,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAElF,MAAM,kBAAE,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,6BAAiB,CAAC,CAAC,CAAC;QACjE,MAAM,kBAAE,CAAC,SAAS,CAAC,6BAAiB,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAE3D,YAAG,CAAC,OAAO,CAAC,SAAS,GAAG,CAAC,IAAI,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QAC5D,YAAG,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACrE,YAAG,CAAC,KAAK,CAAC,eAAe,OAAO,EAAE,CAAC,CAAC;QACpC,YAAG,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACzE,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YAC9C,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/backup.d.ts

@@ -0,0 +1,6 @@
+interface BackupOptions {
+    output?: string;
+}
+export declare function runBackup(options?: BackupOptions): Promise<void>;
+export {};
+//# sourceMappingURL=backup.d.ts.map

package/dist/commands/backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/commands/backup.ts"],"names":[],"mappings":"AAKA,UAAU,aAAa;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB1E"}

package/dist/commands/backup.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBackup = runBackup;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const detector_1 = require("../core/detector");
+const logger_1 = require("../utils/logger");
+async function runBackup(options = {}) {
+    try {
+        const detected = await (0, detector_1.detectVsCodePath)();
+        if (!(await fs_extra_1.default.pathExists(detected.mcpJsonPath))) {
+            logger_1.log.warn("No mcp.json file found to backup.");
+            process.exit(0);
+        }
+        const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+        const backupPath = options.output
+            ? node_path_1.default.resolve(options.output)
+            : node_path_1.default.join(node_path_1.default.dirname(detected.mcpJsonPath), `mcp-backup-${stamp}.json`);
+        await fs_extra_1.default.mkdirp(node_path_1.default.dirname(backupPath));
+        await fs_extra_1.default.copyFile(detected.mcpJsonPath, backupPath);
+        logger_1.log.success(`Backup created at ${backupPath}`);
+        process.exit(0);
+    }
+    catch (err) {
+        logger_1.log.error(`backup failed: ${err instanceof Error ? err.message : "Unknown error"}`);
+        if (process.env.DEBUG && err instanceof Error) {
+            console.error(err.stack);
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=backup.js.map

package/dist/commands/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../src/commands/backup.ts"],"names":[],"mappings":";;;;;AASA,8BAwBC;AAjCD,wDAA0B;AAC1B,0DAA6B;AAC7B,+CAAoD;AACpD,4CAAsC;AAM/B,KAAK,UAAU,SAAS,CAAC,UAAyB,EAAE;IACzD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,IAAA,2BAAgB,GAAE,CAAC;QAC1C,IAAI,CAAC,CAAC,MAAM,kBAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;YACjD,YAAG,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC7D,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM;YAC/B,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;YAC9B,CAAC,CAAC,mBAAI,CAAC,IAAI,CAAC,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC;QAC9E,MAAM,kBAAE,CAAC,MAAM,CAAC,mBAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QAE1C,MAAM,kBAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QACpD,YAAG,CAAC,OAAO,CAAC,qBAAqB,UAAU,EAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,YAAG,CAAC,KAAK,CAAC,kBAAkB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QACpF,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YAC9C,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/completion.d.ts

@@ -0,0 +1,2 @@
+export declare function runCompletion(shell?: string): Promise<void>;
+//# sourceMappingURL=completion.d.ts.map

package/dist/commands/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAyDA,wBAAsB,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BjE"}

package/dist/commands/completion.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCompletion = runCompletion;
+const logger_1 = require("../utils/logger");
+const ZSH_COMPLETION = `
+# mcp-kit zsh completion
+# Add to ~/.zshrc: eval "$(mcp-kit completion zsh)"
+
+mcp_kit_completions() {
+  local -a subcmds
+  subcmds=(
+    'init:Initialise MCP configuration'
+    'add:Add a single MCP server'
+    'remove:Remove a configured MCP server'
+    'update:Update MCP server versions'
+    'status:Show status of configured MCPs'
+    'doctor:Run diagnostics on MCPs'
+    'list:List available MCPs'
+    'reset:Remove all configured MCPs'
+    'export:Export mcp.json to a file'
+    'import:Import an mcp.json file'
+    'install:Pre-install MCP packages'
+    'env:Environment variable commands'
+    'validate:Validate mcp.json schema'
+    'enable:Enable a disabled MCP'
+    'disable:Disable an MCP without removing it'
+    'info:Show details for an MCP'
+    'open:Open mcp.json in VS Code'
+    'backup:Back up mcp.json'
+    'search:Search available MCPs'
+    'completion:Print shell completion script'
+  )
+  _describe 'command' subcmds
+}
+
+compdef mcp_kit_completions mcp-kit
+`.trimStart();
+const BASH_COMPLETION = `
+# mcp-kit bash completion
+# Add to ~/.bashrc: eval "$(mcp-kit completion bash)"
+
+mcp_kit_completions() {
+  local MCP_IDS="azure confluence mssql playwright runbook filesystem git azuredevops postgres slack sonarqube context7 figma everything"
+  local SUBCMDS="init add remove update status doctor list reset export import install env validate enable disable info open backup search completion"
+  local cur prev
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  case "\${prev}" in
+    add|remove|enable|disable|info)
+      COMPREPLY=( $(compgen -W "\${MCP_IDS}" -- "\${cur}") )
+      return ;;
+  esac
+  COMPREPLY=( $(compgen -W "\${SUBCMDS}" -- "\${cur}") )
+}
+
+complete -F mcp_kit_completions mcp-kit
+`.trimStart();
+async function runCompletion(shell) {
+    try {
+        const s = shell?.toLowerCase() ?? "zsh";
+        if (s === "zsh") {
+            process.stdout.write(ZSH_COMPLETION);
+            return;
+        }
+        if (s === "bash") {
+            process.stdout.write(BASH_COMPLETION);
+            return;
+        }
+        logger_1.log.error(`Unsupported shell: '${shell}'. Use 'zsh' or 'bash'.`);
+        logger_1.log.blank();
+        logger_1.log.info("Usage:");
+        logger_1.log.muted("  mcp-kit completion zsh   # zsh");
+        logger_1.log.muted("  mcp-kit completion bash  # bash");
+        logger_1.log.blank();
+        logger_1.log.muted("Then add to your shell profile:");
+        logger_1.log.muted('  echo \'eval "$(mcp-kit completion zsh)"\' >> ~/.zshrc && source ~/.zshrc');
+        process.exit(1);
+    }
+    catch (err) {
+        logger_1.log.error(`completion failed: ${err instanceof Error ? err.message : "Unknown error"}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=completion.js.map

package/dist/commands/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":";;AAyDA,sCA2BC;AApFD,4CAAsC;AAEtC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCtB,CAAC,SAAS,EAAE,CAAC;AAEd,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;CAmBvB,CAAC,SAAS,EAAE,CAAC;AAEP,KAAK,UAAU,aAAa,CAAC,KAAc;IAChD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,KAAK,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;QAExC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;YACrC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC;YACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QAED,YAAG,CAAC,KAAK,CAAC,uBAAuB,KAAK,yBAAyB,CAAC,CAAC;QACjE,YAAG,CAAC,KAAK,EAAE,CAAC;QACZ,YAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnB,YAAG,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAC9C,YAAG,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAC/C,YAAG,CAAC,KAAK,EAAE,CAAC;QACZ,YAAG,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAC7C,YAAG,CAAC,KAAK,CAAC,4EAA4E,CAAC,CAAC;QACxF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,YAAG,CAAC,KAAK,CAAC,sBAAsB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QACxF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+export declare function runDoctor(): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAUA,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAoJ/C"}

package/dist/commands/doctor.js

@@ -0,0 +1,148 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDoctor = runDoctor;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const constants_1 = require("../constants");
+const credentials_1 = require("../core/credentials");
+const detector_1 = require("../core/detector");
+const registry_1 = require("../core/registry");
+const writer_1 = require("../core/writer");
+const validator_1 = require("../core/validator");
+const logger_1 = require("../utils/logger");
+async function runDoctor() {
+    try {
+        logger_1.log.header("🩺 Running diagnostics...");
+        const detected = await (0, detector_1.detectVsCodePath)();
+        if (!(await fs_extra_1.default.pathExists(detected.vscodeFolderPath))) {
+            logger_1.log.warn("No .vscode folder found");
+        }
+        let config;
+        try {
+            config = await (0, writer_1.readMcpJson)(detected.mcpJsonPath);
+        }
+        catch {
+            logger_1.log.error("mcp.json is missing or malformed");
+            process.exit(1);
+            return;
+        }
+        if (Object.keys(config.servers).length === 0) {
+            logger_1.log.error("mcp.json is missing or malformed");
+            process.exit(1);
+        }
+        const meta = (await fs_extra_1.default.pathExists(constants_1.MCP_KIT_META_PATH)) ? await fs_extra_1.default.readJSON(constants_1.MCP_KIT_META_PATH) : {};
+        const storage = (meta.credentialStorage || "keychain");
+        const results = await Promise.all(Object.keys(config.servers).map(async (id) => {
+            const mcp = (0, registry_1.getMcpById)(id);
+            const issues = [];
+            const suggestions = [];
+            let credentialsPresent = true;
+            let packageInstallable = true;
+            let networkReachable;
+            if (!mcp) {
+                issues.push("MCP not found in registry");
+                suggestions.push("Run `mcp-kit list --available` and re-add this MCP");
+                return {
+                    mcpId: id,
+                    mcpName: id,
+                    configured: true,
+                    credentialsPresent: false,
+                    packageInstallable: false,
+                    issues,
+                    suggestions,
+                    status: "error"
+                };
+            }
+            for (const envVar of mcp.envVars.filter((envItem) => envItem.secret)) {
+                const value = await (0, credentials_1.getCredential)(envVar.key, storage);
+                if (!value) {
+                    credentialsPresent = false;
+                    issues.push(`Missing credential: ${envVar.label}`);
+                    suggestions.push(`Run \`mcp-kit add ${id}\` to reconfigure`);
+                }
+            }
+            if (mcp.requiresNetwork && mcp.healthCheckUrl) {
+                networkReachable = await (0, validator_1.checkNetworkReachability)(mcp.healthCheckUrl);
+                if (!networkReachable) {
+                    issues.push(`Cannot reach ${mcp.healthCheckUrl}`);
+                    suggestions.push("Check your VPN / firewall settings");
+                }
+            }
+            packageInstallable = await (0, validator_1.checkNpmPackageExists)(mcp.npmPackage);
+            if (!packageInstallable) {
+                issues.push(`Package ${mcp.npmPackage} not found on npm registry`);
+                suggestions.push("Check npm registry or use offline cache");
+            }
+            try {
+                await fs_extra_1.default.access(detected.mcpJsonPath, fs_extra_1.default.constants.W_OK);
+            }
+            catch {
+                issues.push("mcp.json is not writable");
+                suggestions.push(`Check file permissions: chmod 644 ${detected.mcpJsonPath}`);
+            }
+            const configured = config.servers[id];
+            if (configured.command !== mcp.command || !configured.args.some((arg) => arg.includes(mcp.npmPackage))) {
+                issues.push("Args may be stale — run `mcp-kit update`");
+                suggestions.push("Run `mcp-kit update` to refresh command arguments");
+            }
+            const status = issues.length === 0
+                ? "healthy"
+                : issues.some((issue) => issue.startsWith("Missing credential") || issue.includes("not writable") || issue.includes("not found"))
+                    ? "error"
+                    : "warning";
+            return {
+                mcpId: id,
+                mcpName: mcp.name,
+                configured: true,
+                credentialsPresent,
+                networkReachable,
+                packageInstallable,
+                issues,
+                suggestions,
+                status
+            };
+        }));
+        let healthy = 0;
+        let warnings = 0;
+        let errors = 0;
+        for (const result of results) {
+            if (result.status === "healthy") {
+                healthy += 1;
+                console.log(`✅ ${result.mcpName} — Healthy`);
+            }
+            else if (result.status === "warning") {
+                warnings += 1;
+                console.log(`⚠️ ${result.mcpName} — Warning: ${result.issues[0]}`);
+            }
+            else {
+                errors += 1;
+                console.log(`❌ ${result.mcpName} — Error: ${result.issues[0]}`);
+            }
+            if (result.suggestions[0]) {
+                console.log(`Fix: ${result.suggestions[0]}`);
+            }
+        }
+        console.log("\nSummary:");
+        console.log(`Healthy: ${healthy}`);
+        console.log(`Warnings: ${warnings}`);
+        console.log(`Errors: ${errors}`);
+        if (errors > 0) {
+            logger_1.log.info("Run `mcp-kit add <id>` to fix individual MCPs");
+            logger_1.log.info("Run `mcp-kit reset` to start fresh");
+            process.exit(1);
+        }
+        process.exit(0);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : "Unknown error";
+        logger_1.log.error(`Doctor failed: ${message}`);
+        logger_1.log.muted("Suggestion: validate your network and local file permissions.");
+        if (process.env.DEBUG && err instanceof Error) {
+            console.error(err.stack);
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/commands/env-check.d.ts

@@ -0,0 +1,6 @@
+interface EnvCheckOptions {
+    json?: boolean;
+}
+export declare function runEnvCheck(options?: EnvCheckOptions): Promise<void>;
+export {};
+//# sourceMappingURL=env-check.d.ts.map

package/dist/commands/env-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-check.d.ts","sourceRoot":"","sources":["../../src/commands/env-check.ts"],"names":[],"mappings":"AAOA,UAAU,eAAe;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,WAAW,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2C9E"}

package/dist/commands/env-check.js

@@ -0,0 +1,53 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runEnvCheck = runEnvCheck;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const node_path_1 = __importDefault(require("node:path"));
+const constants_1 = require("../constants");
+const detector_1 = require("../core/detector");
+const writer_1 = require("../core/writer");
+const logger_1 = require("../utils/logger");
+async function runEnvCheck(options = {}) {
+    try {
+        const detected = await (0, detector_1.detectVsCodePath)();
+        const config = await (0, writer_1.readMcpJson)(detected.mcpJsonPath);
+        const envPath = node_path_1.default.join(process.cwd(), ".env");
+        const envContent = (await fs_extra_1.default.pathExists(envPath)) ? await fs_extra_1.default.readFile(envPath, "utf8") : "";
+        const rows = [];
+        for (const [id, server] of Object.entries(config.servers)) {
+            const mcp = constants_1.MCP_REGISTRY.find((item) => item.id === id);
+            if (!mcp) {
+                continue;
+            }
+            for (const envVar of mcp.envVars) {
+                const configured = server.env?.[envVar.key] || "";
+                const isRef = configured.startsWith("${env:");
+                const hasEnv = envContent.includes(`${envVar.key}=`);
+                const status = configured.length === 0
+                    ? (envVar.required ? "Missing" : "Optional")
+                    : isRef
+                        ? (hasEnv ? "OK (.env)" : "Ref missing")
+                        : "Inline";
+                rows.push([id, envVar.key, envVar.required ? "Yes" : "No", status]);
+            }
+        }
+        if (options.json) {
+            console.log(JSON.stringify(rows, null, 2));
+            return;
+        }
+        (0, logger_1.printTable)(["MCP", "Env Key", "Required", "Status"], rows);
+        process.exit(0);
+    }
+    catch (err) {
+        logger_1.log.error(`env-check failed: ${err instanceof Error ? err.message : "Unknown error"}`);
+        logger_1.log.muted("Suggestion: run `mcp-kit init --dev` to repair env mappings.");
+        if (process.env.DEBUG && err instanceof Error) {
+            console.error(err.stack);
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=env-check.js.map

package/dist/commands/env-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-check.js","sourceRoot":"","sources":["../../src/commands/env-check.ts"],"names":[],"mappings":"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"}

package/dist/commands/export.d.ts

@@ -0,0 +1,5 @@
+export declare function runExport(options: {
+    output: string;
+    redact: boolean;
+}): Promise<void>;
+//# sourceMappingURL=export.d.ts.map

package/dist/commands/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAMA,wBAAsB,SAAS,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgD3F"}