mcp-config-ts 0.3.0

package/dist/__tests__/validation/validate.test.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+const crypto_1 = require("crypto");
+const validate_1 = require("../../validation/validate");
+(0, vitest_1.describe)('validateConfig', () => {
+    const dirs = [];
+    (0, vitest_1.afterEach)(() => {
+        for (const dir of dirs) {
+            try {
+                (0, fs_1.rmSync)(dir, { recursive: true, force: true });
+            }
+            catch { /* ignore */ }
+        }
+        dirs.length = 0;
+    });
+    function tmpFile(content) {
+        const dir = (0, path_1.join)((0, os_1.tmpdir)(), `mcp-config-test-${(0, crypto_1.randomUUID)()}`);
+        (0, fs_1.mkdirSync)(dir, { recursive: true });
+        dirs.push(dir);
+        const file = (0, path_1.join)(dir, '.mcp.json');
+        (0, fs_1.writeFileSync)(file, content);
+        return file;
+    }
+    function makeConfig(servers, filePath, _otherKeys) {
+        return { servers, filePath, _otherKeys };
+    }
+    (0, vitest_1.it)('valid config with stdio server passes all checks', async () => {
+        const file = tmpFile(JSON.stringify({ mcpServers: { fs: { command: 'npx' } } }));
+        const config = makeConfig({ fs: { type: 'stdio', command: 'npx' } }, file);
+        const result = await (0, validate_1.validateConfig)(config);
+        (0, vitest_1.expect)(result.valid).toBe(true);
+        (0, vitest_1.expect)(result.completenessScore).toBe(100);
+        (0, vitest_1.expect)(result.summary.failed).toBe(0);
+    });
+    (0, vitest_1.it)('valid config with http server passes', async () => {
+        const file = tmpFile(JSON.stringify({ mcpServers: { r: { url: 'https://example.com' } } }));
+        const config = makeConfig({ r: { type: 'http', url: 'https://example.com' } }, file);
+        const result = await (0, validate_1.validateConfig)(config);
+        (0, vitest_1.expect)(result.valid).toBe(true);
+    });
+    (0, vitest_1.it)('file not found produces json-syntax failure', async () => {
+        const config = makeConfig({}, '/nonexistent/path/.mcp.json');
+        const result = await (0, validate_1.validateConfig)(config);
+        const syntaxCheck = result.checks.find(c => c.id === 'json-syntax');
+        (0, vitest_1.expect)(syntaxCheck?.passed).toBe(false);
+    });
+    (0, vitest_1.it)('invalid JSON produces json-syntax failure', async () => {
+        const file = tmpFile('{ this is not json }');
+        const config = makeConfig({}, file);
+        const result = await (0, validate_1.validateConfig)(config);
+        (0, vitest_1.expect)(result.valid).toBe(false);
+        const syntaxCheck = result.checks.find(c => c.id === 'json-syntax');
+        (0, vitest_1.expect)(syntaxCheck?.passed).toBe(false);
+    });
+    (0, vitest_1.it)('level 1 only includes json-syntax check', async () => {
+        const file = tmpFile(JSON.stringify({ mcpServers: {} }));
+        const config = makeConfig({}, file);
+        const result = await (0, validate_1.validateConfig)(config, { level: 1 });
+        (0, vitest_1.expect)(result.checks).toHaveLength(1);
+        (0, vitest_1.expect)(result.checks[0].id).toBe('json-syntax');
+    });
+    (0, vitest_1.it)('level 2 includes json-syntax and schema checks', async () => {
+        const file = tmpFile(JSON.stringify({ mcpServers: {} }));
+        const config = makeConfig({}, file);
+        const result = await (0, validate_1.validateConfig)(config, { level: 2 });
+        (0, vitest_1.expect)(result.checks.length).toBeGreaterThan(1);
+        (0, vitest_1.expect)(result.checks.some(c => c.id === 'json-syntax')).toBe(true);
+        (0, vitest_1.expect)(result.checks.some(c => c.id === 'has-mcp-servers')).toBe(true);
+    });
+    (0, vitest_1.it)('level 3 (default) includes all checks', async () => {
+        const file = tmpFile(JSON.stringify({ mcpServers: {} }));
+        const config = makeConfig({}, file);
+        const result = await (0, validate_1.validateConfig)(config, { level: 3 });
+        (0, vitest_1.expect)(result.checks.some(c => c.id === 'json-syntax')).toBe(true);
+        (0, vitest_1.expect)(result.checks.some(c => c.id === 'has-mcp-servers')).toBe(true);
+        (0, vitest_1.expect)(result.checks.some(c => c.id === 'url-format')).toBe(true);
+    });
+    (0, vitest_1.it)('http server with invalid URL produces url-format warning', async () => {
+        const file = tmpFile(JSON.stringify({ mcpServers: { bad: { url: 'ftp://invalid' } } }));
+        const config = makeConfig({ bad: { type: 'http', url: 'ftp://invalid' } }, file);
+        const result = await (0, validate_1.validateConfig)(config);
+        const urlCheck = result.checks.find(c => c.id === 'url-format');
+        (0, vitest_1.expect)(urlCheck?.passed).toBe(false);
+        (0, vitest_1.expect)(urlCheck?.severity).toBe('warning');
+    });
+    (0, vitest_1.it)('valid is false only when error-severity checks fail', async () => {
+        const file = tmpFile(JSON.stringify({ mcpServers: { r: { url: 'ftp://bad' } } }));
+        const config = makeConfig({ r: { type: 'http', url: 'ftp://bad' } }, file);
+        const result = await (0, validate_1.validateConfig)(config);
+        // url-format is a warning, json-syntax passes, has-mcp-servers passes
+        (0, vitest_1.expect)(result.valid).toBe(true);
+    });
+    (0, vitest_1.it)('completenessScore is reduced by warning failures', async () => {
+        const file = tmpFile(JSON.stringify({ mcpServers: { r: { url: 'ftp://bad' } } }));
+        const config = makeConfig({ r: { type: 'http', url: 'ftp://bad' } }, file);
+        const result = await (0, validate_1.validateConfig)(config);
+        (0, vitest_1.expect)(result.completenessScore).toBeLessThan(100);
+    });
+    (0, vitest_1.it)('completenessScore is 0 or clamped when many errors', async () => {
+        const config = makeConfig({}, '/nonexistent/.mcp.json');
+        const result = await (0, validate_1.validateConfig)(config);
+        (0, vitest_1.expect)(result.completenessScore).toBeGreaterThanOrEqual(0);
+        (0, vitest_1.expect)(result.completenessScore).toBeLessThanOrEqual(100);
+    });
+    (0, vitest_1.it)('configPath in result matches config.filePath', async () => {
+        const file = tmpFile(JSON.stringify({ mcpServers: {} }));
+        const config = makeConfig({}, file);
+        const result = await (0, validate_1.validateConfig)(config);
+        (0, vitest_1.expect)(result.configPath).toBe(file);
+    });
+    (0, vitest_1.it)('summary counts are correct', async () => {
+        const file = tmpFile(JSON.stringify({ mcpServers: { s: { command: 'node' } } }));
+        const config = makeConfig({ s: { type: 'stdio', command: 'node' } }, file);
+        const result = await (0, validate_1.validateConfig)(config);
+        (0, vitest_1.expect)(result.summary.total).toBe(result.checks.length);
+        (0, vitest_1.expect)(result.summary.passed + result.summary.failed).toBe(result.summary.total);
+    });
+});
+//# sourceMappingURL=validate.test.js.map

package/dist/__tests__/validation/validate.test.js.map

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

package/dist/config/load.d.ts

@@ -0,0 +1,3 @@
+import type { MCPConfig } from '../types';
+export declare function loadConfig(configPath?: string): MCPConfig;
+//# sourceMappingURL=load.d.ts.map

package/dist/config/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAkD,MAAM,UAAU,CAAA;AAKzF,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAgEzD"}

package/dist/config/load.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const errors_1 = require("../utils/errors");
+const DEFAULT_CONFIG_PATH = '.mcp.json';
+function loadConfig(configPath) {
+    const filePath = (0, path_1.resolve)(configPath ?? DEFAULT_CONFIG_PATH);
+    if (!(0, fs_1.existsSync)(filePath)) {
+        throw new errors_1.ConfigNotFoundError(filePath);
+    }
+    let raw;
+    try {
+        raw = (0, fs_1.readFileSync)(filePath, 'utf-8');
+    }
+    catch {
+        throw new errors_1.ConfigNotFoundError(filePath);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        const syntaxErr = err instanceof SyntaxError ? err : undefined;
+        throw new errors_1.ConfigParseError(syntaxErr?.message ?? 'Failed to parse JSON', filePath, syntaxErr);
+    }
+    const { mcpServers, ...rest } = parsed;
+    const servers = {};
+    if (mcpServers != null && typeof mcpServers === 'object' && !Array.isArray(mcpServers)) {
+        for (const [name, rawEntry] of Object.entries(mcpServers)) {
+            if (rawEntry == null || typeof rawEntry !== 'object' || Array.isArray(rawEntry)) {
+                continue;
+            }
+            const entry = rawEntry;
+            if (typeof entry.command === 'string') {
+                const stdioEntry = { type: 'stdio', command: entry.command };
+                if (Array.isArray(entry.args))
+                    stdioEntry.args = entry.args;
+                if (entry.env != null && typeof entry.env === 'object' && !Array.isArray(entry.env)) {
+                    stdioEntry.env = entry.env;
+                }
+                if (typeof entry.cwd === 'string')
+                    stdioEntry.cwd = entry.cwd;
+                if (typeof entry.disabled === 'boolean')
+                    stdioEntry.disabled = entry.disabled;
+                servers[name] = stdioEntry;
+            }
+            else if (typeof entry.url === 'string') {
+                const httpEntry = { type: 'http', url: entry.url };
+                if (entry.headers != null && typeof entry.headers === 'object' && !Array.isArray(entry.headers)) {
+                    httpEntry.headers = entry.headers;
+                }
+                if (typeof entry.disabled === 'boolean')
+                    httpEntry.disabled = entry.disabled;
+                servers[name] = httpEntry;
+            }
+        }
+    }
+    const config = { servers, filePath };
+    if (Object.keys(rest).length > 0) {
+        config._otherKeys = rest;
+    }
+    return config;
+}
+//# sourceMappingURL=load.js.map

package/dist/config/load.js.map

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

package/dist/config/manager.d.ts

@@ -0,0 +1,3 @@
+import type { ConfigManager, ManagerOptions } from '../types';
+export declare function createManager(options?: ManagerOptions): ConfigManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/config/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/config/manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAA4C,MAAM,UAAU,CAAA;AASvG,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa,CAyDrE"}

package/dist/config/manager.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createManager = createManager;
+const path_1 = require("path");
+const errors_1 = require("../utils/errors");
+const load_1 = require("./load");
+const save_1 = require("./save");
+const validate_1 = require("../validation/validate");
+const operations_1 = require("./operations");
+const DEFAULT_CONFIG_PATH = '.mcp.json';
+function createManager(options) {
+    const configPath = (0, path_1.resolve)(options?.configPath ?? DEFAULT_CONFIG_PATH);
+    let _config = null;
+    function assertLoaded() {
+        if (_config == null) {
+            throw new Error('Config not loaded. Call load() first.');
+        }
+        return _config;
+    }
+    return {
+        async load() {
+            _config = (0, load_1.loadConfig)(configPath);
+        },
+        async save() {
+            const config = assertLoaded();
+            (0, save_1.saveConfig)(config);
+        },
+        getConfig() {
+            return assertLoaded();
+        },
+        list() {
+            return (0, operations_1.listServers)(assertLoaded());
+        },
+        get(serverName) {
+            return (0, operations_1.getServer)(assertLoaded(), serverName);
+        },
+        add(serverName, entry) {
+            (0, operations_1.addServer)(assertLoaded(), serverName, entry);
+        },
+        addFromRegistry(_registryName, _envValues) {
+            throw new errors_1.ServerNotFoundError(_registryName);
+        },
+        remove(serverName) {
+            (0, operations_1.removeServer)(assertLoaded(), serverName);
+        },
+        async validate(opts) {
+            const config = assertLoaded();
+            const level = (opts?.level ?? 3);
+            const clampedLevel = level > 3 ? 3 : level < 1 ? 1 : level;
+            return (0, validate_1.validateConfig)(config, { level: clampedLevel });
+        },
+        has(serverName) {
+            const config = assertLoaded();
+            return Object.prototype.hasOwnProperty.call(config.servers, serverName);
+        },
+    };
+}
+//# sourceMappingURL=manager.js.map

package/dist/config/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/config/manager.ts"],"names":[],"mappings":";;AAUA,sCAyDC;AAnED,+BAA8B;AAE9B,4CAAqD;AACrD,iCAAmC;AACnC,iCAAmC;AACnC,qDAAuD;AACvD,6CAA8E;AAE9E,MAAM,mBAAmB,GAAG,WAAW,CAAA;AAEvC,SAAgB,aAAa,CAAC,OAAwB;IACpD,MAAM,UAAU,GAAG,IAAA,cAAO,EAAC,OAAO,EAAE,UAAU,IAAI,mBAAmB,CAAC,CAAA;IACtE,IAAI,OAAO,GAAqB,IAAI,CAAA;IAEpC,SAAS,YAAY;QACnB,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;QAC1D,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,OAAO;QACL,KAAK,CAAC,IAAI;YACR,OAAO,GAAG,IAAA,iBAAU,EAAC,UAAU,CAAC,CAAA;QAClC,CAAC;QAED,KAAK,CAAC,IAAI;YACR,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;YAC7B,IAAA,iBAAU,EAAC,MAAM,CAAC,CAAA;QACpB,CAAC;QAED,SAAS;YACP,OAAO,YAAY,EAAE,CAAA;QACvB,CAAC;QAED,IAAI;YACF,OAAO,IAAA,wBAAW,EAAC,YAAY,EAAE,CAAC,CAAA;QACpC,CAAC;QAED,GAAG,CAAC,UAAkB;YACpB,OAAO,IAAA,sBAAS,EAAC,YAAY,EAAE,EAAE,UAAU,CAAC,CAAA;QAC9C,CAAC;QAED,GAAG,CAAC,UAAkB,EAAE,KAAkB;YACxC,IAAA,sBAAS,EAAC,YAAY,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,CAAA;QAC9C,CAAC;QAED,eAAe,CAAC,aAAqB,EAAE,UAAmC;YACxE,MAAM,IAAI,4BAAmB,CAAC,aAAa,CAAC,CAAA;QAC9C,CAAC;QAED,MAAM,CAAC,UAAkB;YACvB,IAAA,yBAAY,EAAC,YAAY,EAAE,EAAE,UAAU,CAAC,CAAA;QAC1C,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,IAAoC;YACjD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;YAC7B,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,CAAc,CAAA;YAC7C,MAAM,YAAY,GAAc,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;YACrE,OAAO,IAAA,yBAAc,EAAC,MAAM,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAA;QACxD,CAAC;QAED,GAAG,CAAC,UAAkB;YACpB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;YAC7B,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;QACzE,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/config/operations.d.ts

@@ -0,0 +1,6 @@
+import type { MCPConfig, ServerEntry } from '../types';
+export declare function addServer(config: MCPConfig, name: string, entry: ServerEntry): void;
+export declare function removeServer(config: MCPConfig, name: string): void;
+export declare function getServer(config: MCPConfig, name: string): ServerEntry | undefined;
+export declare function listServers(config: MCPConfig): string[];
+//# sourceMappingURL=operations.d.ts.map

package/dist/config/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/config/operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAGtD,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAKnF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAKlE;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAElF;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,EAAE,CAEvD"}

package/dist/config/operations.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addServer = addServer;
+exports.removeServer = removeServer;
+exports.getServer = getServer;
+exports.listServers = listServers;
+const errors_1 = require("../utils/errors");
+function addServer(config, name, entry) {
+    if (Object.prototype.hasOwnProperty.call(config.servers, name)) {
+        throw new errors_1.ServerExistsError(name);
+    }
+    config.servers[name] = entry;
+}
+function removeServer(config, name) {
+    if (!Object.prototype.hasOwnProperty.call(config.servers, name)) {
+        throw new errors_1.ServerNotFoundError(name);
+    }
+    delete config.servers[name];
+}
+function getServer(config, name) {
+    return config.servers[name];
+}
+function listServers(config) {
+    return Object.keys(config.servers).sort();
+}
+//# sourceMappingURL=operations.js.map

package/dist/config/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/config/operations.ts"],"names":[],"mappings":";;AAGA,8BAKC;AAED,oCAKC;AAED,8BAEC;AAED,kCAEC;AAtBD,4CAAwE;AAExE,SAAgB,SAAS,CAAC,MAAiB,EAAE,IAAY,EAAE,KAAkB;IAC3E,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,0BAAiB,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC;IACD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;AAC9B,CAAC;AAED,SAAgB,YAAY,CAAC,MAAiB,EAAE,IAAY;IAC1D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,4BAAmB,CAAC,IAAI,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AAC7B,CAAC;AAED,SAAgB,SAAS,CAAC,MAAiB,EAAE,IAAY;IACvD,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AAC7B,CAAC;AAED,SAAgB,WAAW,CAAC,MAAiB;IAC3C,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAA;AAC3C,CAAC"}

package/dist/config/save.d.ts

@@ -0,0 +1,3 @@
+import type { MCPConfig } from '../types';
+export declare function saveConfig(config: MCPConfig): void;
+//# sourceMappingURL=save.d.ts.map

package/dist/config/save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../src/config/save.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAkD,MAAM,UAAU,CAAA;AAoBzF,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAYlD"}

package/dist/config/save.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveConfig = saveConfig;
+const fs_1 = require("fs");
+const path_1 = require("path");
+function serializeEntry(entry) {
+    if (entry.type === 'stdio') {
+        const e = entry;
+        const out = { command: e.command };
+        if (e.args != null)
+            out.args = e.args;
+        if (e.env != null)
+            out.env = e.env;
+        if (e.cwd != null)
+            out.cwd = e.cwd;
+        if (e.disabled != null)
+            out.disabled = e.disabled;
+        return out;
+    }
+    else {
+        const e = entry;
+        const out = { url: e.url };
+        if (e.headers != null)
+            out.headers = e.headers;
+        if (e.disabled != null)
+            out.disabled = e.disabled;
+        return out;
+    }
+}
+function saveConfig(config) {
+    const dir = (0, path_1.dirname)(config.filePath);
+    (0, fs_1.mkdirSync)(dir, { recursive: true });
+    const mcpServers = {};
+    for (const [name, entry] of Object.entries(config.servers)) {
+        mcpServers[name] = serializeEntry(entry);
+    }
+    const output = { ...(config._otherKeys ?? {}), mcpServers };
+    (0, fs_1.writeFileSync)(config.filePath, JSON.stringify(output, null, 2) + '\n', 'utf-8');
+}
+//# sourceMappingURL=save.js.map

package/dist/config/save.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.js","sourceRoot":"","sources":["../../src/config/save.ts"],"names":[],"mappings":";;AAsBA,gCAYC;AAlCD,2BAA6C;AAC7C,+BAA8B;AAG9B,SAAS,cAAc,CAAC,KAAkB;IACxC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,KAAyB,CAAA;QACnC,MAAM,GAAG,GAA4B,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAA;QAC3D,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI;YAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAA;QACrC,IAAI,CAAC,CAAC,GAAG,IAAI,IAAI;YAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAA;QAClC,IAAI,CAAC,CAAC,GAAG,IAAI,IAAI;YAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAA;QAClC,IAAI,CAAC,CAAC,QAAQ,IAAI,IAAI;YAAE,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAA;QACjD,OAAO,GAAG,CAAA;IACZ,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,GAAG,KAAwB,CAAA;QAClC,MAAM,GAAG,GAA4B,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAA;QACnD,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI;YAAE,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAA;QAC9C,IAAI,CAAC,CAAC,QAAQ,IAAI,IAAI;YAAE,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAA;QACjD,OAAO,GAAG,CAAA;IACZ,CAAC;AACH,CAAC;AAED,SAAgB,UAAU,CAAC,MAAiB;IAC1C,MAAM,GAAG,GAAG,IAAA,cAAO,EAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACpC,IAAA,cAAS,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAEnC,MAAM,UAAU,GAA4B,EAAE,CAAA;IAC9C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3D,UAAU,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;IAC1C,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,CAAA;IAEpF,IAAA,kBAAa,EAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAA;AACjF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export type { StdioServerEntry, HttpServerEntry, ServerEntry, MCPConfig, ValidationCheck, ValidationResult, SyncOptions, SyncResult, ServerInfo, DiscoverOptions, ManagerOptions, ConfigManager, RegistryEntry, } from './types';
+export { MCPConfigError, ConfigNotFoundError, ConfigParseError, ServerExistsError, ServerNotFoundError, ValidationError, } from './utils/errors';
+export { loadConfig } from './config/load';
+export { saveConfig } from './config/save';
+export { addServer, removeServer, getServer, listServers } from './config/operations';
+export { createManager } from './config/manager';
+export { validateConfig } from './validation/validate';
+export { validateJsonSyntax } from './validation/json-syntax';
+export { validateSchema } from './validation/schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,UAAU,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateSchema = exports.validateJsonSyntax = exports.validateConfig = exports.createManager = exports.listServers = exports.getServer = exports.removeServer = exports.addServer = exports.saveConfig = exports.loadConfig = exports.ValidationError = exports.ServerNotFoundError = exports.ServerExistsError = exports.ConfigParseError = exports.ConfigNotFoundError = exports.MCPConfigError = void 0;
+var errors_1 = require("./utils/errors");
+Object.defineProperty(exports, "MCPConfigError", { enumerable: true, get: function () { return errors_1.MCPConfigError; } });
+Object.defineProperty(exports, "ConfigNotFoundError", { enumerable: true, get: function () { return errors_1.ConfigNotFoundError; } });
+Object.defineProperty(exports, "ConfigParseError", { enumerable: true, get: function () { return errors_1.ConfigParseError; } });
+Object.defineProperty(exports, "ServerExistsError", { enumerable: true, get: function () { return errors_1.ServerExistsError; } });
+Object.defineProperty(exports, "ServerNotFoundError", { enumerable: true, get: function () { return errors_1.ServerNotFoundError; } });
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });
+var load_1 = require("./config/load");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return load_1.loadConfig; } });
+var save_1 = require("./config/save");
+Object.defineProperty(exports, "saveConfig", { enumerable: true, get: function () { return save_1.saveConfig; } });
+var operations_1 = require("./config/operations");
+Object.defineProperty(exports, "addServer", { enumerable: true, get: function () { return operations_1.addServer; } });
+Object.defineProperty(exports, "removeServer", { enumerable: true, get: function () { return operations_1.removeServer; } });
+Object.defineProperty(exports, "getServer", { enumerable: true, get: function () { return operations_1.getServer; } });
+Object.defineProperty(exports, "listServers", { enumerable: true, get: function () { return operations_1.listServers; } });
+var manager_1 = require("./config/manager");
+Object.defineProperty(exports, "createManager", { enumerable: true, get: function () { return manager_1.createManager; } });
+var validate_1 = require("./validation/validate");
+Object.defineProperty(exports, "validateConfig", { enumerable: true, get: function () { return validate_1.validateConfig; } });
+var json_syntax_1 = require("./validation/json-syntax");
+Object.defineProperty(exports, "validateJsonSyntax", { enumerable: true, get: function () { return json_syntax_1.validateJsonSyntax; } });
+var schema_1 = require("./validation/schema");
+Object.defineProperty(exports, "validateSchema", { enumerable: true, get: function () { return schema_1.validateSchema; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAgBA,yCAOwB;AANtB,wGAAA,cAAc,OAAA;AACd,6GAAA,mBAAmB,OAAA;AACnB,0GAAA,gBAAgB,OAAA;AAChB,2GAAA,iBAAiB,OAAA;AACjB,6GAAA,mBAAmB,OAAA;AACnB,yGAAA,eAAe,OAAA;AAEjB,sCAA2C;AAAlC,kGAAA,UAAU,OAAA;AACnB,sCAA2C;AAAlC,kGAAA,UAAU,OAAA;AACnB,kDAAsF;AAA7E,uGAAA,SAAS,OAAA;AAAE,0GAAA,YAAY,OAAA;AAAE,uGAAA,SAAS,OAAA;AAAE,yGAAA,WAAW,OAAA;AACxD,4CAAiD;AAAxC,wGAAA,aAAa,OAAA;AACtB,kDAAuD;AAA9C,0GAAA,cAAc,OAAA;AACvB,wDAA8D;AAArD,iHAAA,kBAAkB,OAAA;AAC3B,8CAAqD;AAA5C,wGAAA,cAAc,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,165 @@
+/** A stdio server entry. */
+export interface StdioServerEntry {
+    type: 'stdio';
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    disabled?: boolean;
+}
+/** An HTTP server entry. */
+export interface HttpServerEntry {
+    type: 'http';
+    url: string;
+    headers?: Record<string, string>;
+    disabled?: boolean;
+}
+/** A server entry (stdio or HTTP). */
+export type ServerEntry = StdioServerEntry | HttpServerEntry;
+/** A parsed MCP configuration. */
+export interface MCPConfig {
+    /** The servers declared in this config. */
+    servers: Record<string, ServerEntry>;
+    /** The file path this config was loaded from. */
+    filePath: string;
+    /** Non-MCP keys in the original file, preserved for round-trip writing. */
+    _otherKeys?: Record<string, unknown>;
+}
+/** An individual validation check result. */
+export interface ValidationCheck {
+    /** Check identifier (e.g., 'json-syntax', 'schema-mcpservers-present', 'command-exists:npx'). */
+    id: string;
+    /** Severity: 'error' for hard failures, 'warning' for potential issues. */
+    severity: 'error' | 'warning';
+    /** Whether this check passed. */
+    passed: boolean;
+    /** Human-readable description of what was checked. */
+    message: string;
+    /** The server name this check applies to, if server-specific. */
+    serverName?: string;
+    /** Suggestion for fixing the issue, if applicable. */
+    suggestion?: string;
+}
+/** Result of config validation. */
+export interface ValidationResult {
+    /** Whether the config passed all checks. */
+    valid: boolean;
+    /** Path to the validated config file. */
+    configPath: string;
+    /** Individual check results. */
+    checks: ValidationCheck[];
+    /** Summary counts. */
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+        warnings: number;
+    };
+    /** Completeness score (0-100). */
+    completenessScore: number;
+}
+export interface SyncOptions {
+    /** Path to the source config file, or a tool alias ('claude-desktop', 'cursor', 'windsurf', 'cline'). */
+    source: string;
+    /** Path to the target config file, or a tool alias. */
+    target: string;
+    /** Which servers to sync. If omitted, all servers from the source are synced. */
+    servers?: string[];
+    /** How to handle conflicts when the target already has a server with the same name. */
+    conflictStrategy: 'skip' | 'overwrite' | 'merge-env';
+    /** If true, perform a dry run: report what would change without modifying the target. */
+    dryRun: boolean;
+}
+export interface SyncResult {
+    /** Path to the source config file. */
+    sourcePath: string;
+    /** Path to the target config file. */
+    targetPath: string;
+    /** Servers that were added to the target (new). */
+    added: string[];
+    /** Servers that were updated in the target (overwrite or merge-env). */
+    updated: string[];
+    /** Servers that were skipped (already exist in target, strategy is 'skip'). */
+    skipped: string[];
+    /** Servers in the source that were not synced due to errors. */
+    errors: Array<{
+        serverName: string;
+        error: string;
+    }>;
+    /** Whether any changes were made (false for dry runs or when everything is skipped). */
+    changed: boolean;
+}
+/** Information about a discoverable MCP server. */
+export interface ServerInfo {
+    name: string;
+    description: string;
+    npmPackage: string;
+    category: string;
+    requiredEnvVars: Array<{
+        name: string;
+        description: string;
+        sensitive: boolean;
+    }>;
+    source: 'registry' | 'npm';
+    weeklyDownloads?: number;
+    homepage?: string;
+}
+export interface DiscoverOptions {
+    /** Whether to also search the npm registry. */
+    searchNpm?: boolean;
+    /** Maximum number of results to return. */
+    limit?: number;
+}
+export interface ManagerOptions {
+    /** Default config file path. Defaults to `.mcp.json` in cwd. */
+    configPath?: string;
+    /** Validation level for automatic validation. */
+    validationLevel?: 1 | 2 | 3 | 4 | 5;
+}
+export interface ConfigManager {
+    /** Load the config from disk. */
+    load(): Promise<void>;
+    /** Save the current config to disk. */
+    save(): Promise<void>;
+    /** Get the current config. Throws if not loaded. */
+    getConfig(): MCPConfig;
+    /** List all server names. */
+    list(): string[];
+    /** Get a specific server entry. */
+    get(serverName: string): ServerEntry | undefined;
+    /** Add a server. Throws if it already exists. */
+    add(serverName: string, entry: ServerEntry): void;
+    /** Add a server from the built-in registry. */
+    addFromRegistry(registryName: string, envValues?: Record<string, string>): void;
+    /** Remove a server. Throws if it does not exist. */
+    remove(serverName: string): void;
+    /** Validate the current config. */
+    validate(options?: {
+        level?: 1 | 2 | 3 | 4 | 5;
+    }): Promise<ValidationResult>;
+    /** Check if a server exists. */
+    has(serverName: string): boolean;
+}
+export interface RegistryEntry {
+    name: string;
+    description: string;
+    npmPackage: string;
+    category: string;
+    entry: ServerEntry;
+    requiredEnvVars?: Array<{
+        name: string;
+        description: string;
+        example: string;
+        sensitive: boolean;
+    }>;
+    optionalEnvVars?: Array<{
+        name: string;
+        description: string;
+        example: string;
+        default?: string;
+        sensitive: boolean;
+    }>;
+    keywords: string[];
+    homepage?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// ── Config Types ─────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,wEAAwE"}