mcp-config-ts 0.3.0

package/README.md

@@ -0,0 +1,195 @@
+# mcp-config-ts
+
+CLI to discover, add, validate, and sync MCP server configs.
+
+## Installation
+
+```bash
+npm install mcp-config-ts
+```
+
+Or run directly with npx:
+
+```bash
+npx mcp-config-ts validate
+```
+
+## Quick Start
+
+```typescript
+import {
+  loadConfig,
+  saveConfig,
+  validateConfig,
+  addServer,
+  removeServer,
+  getServer,
+  listServers,
+  createManager,
+} from 'mcp-config-ts';
+
+// Load a config file (synchronous)
+const config = loadConfig('.mcp.json');
+
+// Validate the config
+const result = await validateConfig(config, { level: 3 });
+console.log(result.valid); // true or false
+console.log(result.completenessScore); // 0-100
+
+// Add a server (mutates config in place)
+addServer(config, 'my-server', {
+  type: 'stdio',
+  command: 'npx',
+  args: ['-y', '@modelcontextprotocol/server-filesystem', '/path/to/dir'],
+});
+
+// Save the config (synchronous, creates parent dirs automatically)
+saveConfig(config);
+
+// Remove a server (mutates config in place)
+removeServer(config, 'my-server');
+
+// List all server names (sorted)
+const names = listServers(config); // ['github', 'filesystem', ...]
+
+// Get a single server entry
+const entry = getServer(config, 'github'); // ServerEntry | undefined
+
+// Use the ConfigManager for stateful load/save/validate operations
+const manager = createManager({ configPath: '.mcp.json' });
+await manager.load();
+manager.add('github', {
+  type: 'stdio',
+  command: 'npx',
+  args: ['-y', '@modelcontextprotocol/server-github'],
+  env: { GITHUB_TOKEN: process.env.GITHUB_TOKEN! },
+});
+await manager.save();
+```
+
+## API Reference
+
+### `loadConfig(configPath?: string): MCPConfig`
+
+Loads and parses an MCP config file synchronously.
+
+- `configPath` defaults to `.mcp.json` in the current working directory.
+- Throws `ConfigNotFoundError` if the file does not exist.
+- Throws `ConfigParseError` if the file is not valid JSON.
+- Infers `type: 'stdio'` for entries with a `command` field, `type: 'http'` for entries with a `url` field.
+- Non-`mcpServers` keys are preserved in `config._otherKeys` for round-trip writing.
+
+### `saveConfig(config: MCPConfig): void`
+
+Writes an `MCPConfig` object to disk synchronously.
+
+- Creates parent directories automatically (`mkdirSync` with `recursive: true`).
+- Strips the `type` field from each server entry (not stored on disk).
+- Merges `_otherKeys` back into the output so non-MCP fields are preserved.
+- Writes JSON with 2-space indentation and a trailing newline.
+
+### `validateConfig(config: MCPConfig, options?: { level?: 1 | 2 | 3 }): Promise<ValidationResult>`
+
+Validates an `MCPConfig` object and returns a `ValidationResult`.
+
+- `level 1`: JSON syntax check only.
+- `level 2`: JSON syntax + schema checks (mcpServers present, entries valid).
+- `level 3` (default): all checks including URL format and non-empty command warnings.
+- `completenessScore`: 0–100, reduced by 30 per error failure and 10 per warning failure.
+- `valid`: `true` only when no error-severity checks fail.
+
+### `createManager(options?: ManagerOptions): ConfigManager`
+
+Creates a stateful config manager.
+
+- `options.configPath`: path to the config file (defaults to `.mcp.json`).
+- Call `manager.load()` before any other methods.
+- Mutations (`add`, `remove`) are in-memory until `manager.save()` is called.
+
+#### `ConfigManager` methods
+
+| Method | Description |
+|---|---|
+| `load(): Promise<void>` | Load config from disk |
+| `save(): Promise<void>` | Persist current config to disk |
+| `getConfig(): MCPConfig` | Return the loaded config object |
+| `list(): string[]` | Return sorted array of server names |
+| `get(name): ServerEntry \| undefined` | Return a server entry by name |
+| `has(name): boolean` | Check if a server exists |
+| `add(name, entry): void` | Add a server (throws `ServerExistsError` if exists) |
+| `remove(name): void` | Remove a server (throws `ServerNotFoundError` if missing) |
+| `validate(opts?): Promise<ValidationResult>` | Validate the current config |
+
+### `addServer(config, name, entry): void`
+
+Adds a server entry to the config in place. Throws `ServerExistsError` if a server with that name already exists.
+
+### `removeServer(config, name): void`
+
+Removes a server entry from the config in place. Throws `ServerNotFoundError` if the server does not exist.
+
+### `getServer(config, name): ServerEntry | undefined`
+
+Returns the server entry for the given name, or `undefined` if not found.
+
+### `listServers(config): string[]`
+
+Returns a sorted array of all server names in the config.
+
+## Available Exports
+
+### Types
+
+- `MCPConfig` -- Parsed MCP configuration object
+- `StdioServerEntry` -- A stdio transport server entry
+- `HttpServerEntry` -- An HTTP transport server entry
+- `ServerEntry` -- Union of StdioServerEntry | HttpServerEntry
+- `ValidationCheck` -- Individual validation check result
+- `ValidationResult` -- Full validation result with summary and completeness score
+- `SyncOptions` -- Options for syncing configs between files
+- `SyncResult` -- Result of a sync operation
+- `ServerInfo` -- Discoverable MCP server info
+- `DiscoverOptions` -- Options for server discovery
+- `ManagerOptions` -- Options for creating a ConfigManager
+- `ConfigManager` -- Stateful config manager interface
+- `RegistryEntry` -- Built-in server registry entry
+
+### Error Classes
+
+- `MCPConfigError` -- Base error class (code: string)
+- `ConfigNotFoundError` -- Config file not found (code: `CONFIG_NOT_FOUND`)
+- `ConfigParseError` -- Config file is not valid JSON (code: `CONFIG_PARSE_ERROR`)
+- `ServerExistsError` -- Server already exists in config (code: `SERVER_EXISTS`)
+- `ServerNotFoundError` -- Server not found in config or registry (code: `SERVER_NOT_FOUND`)
+- `ValidationError` -- Validation failed at a critical level (code: `VALIDATION_ERROR`)
+
+## CLI Commands
+
+```
+mcp-config validate [--config <path>] [--level <1-5>] [--format json]
+    Validate the MCP config file. Exits with code 1 if validation fails.
+
+mcp-config add <name> [--command <cmd>] [--args <args...>] [--url <url>] [--env KEY=VAL]
+    Add a server to the config. Supports registry lookup by name.
+
+mcp-config list [--all] [--format json]
+    List servers in the config. Use --all to scan all known config locations.
+
+mcp-config sync <source> <target> [--strategy skip|overwrite|merge-env] [--dry-run]
+    Sync servers from one config to another.
+
+mcp-config search <query> [--npm] [--limit <n>]
+    Search for MCP servers in the built-in registry and npm.
+
+mcp-config doctor [--check-npm] [--check-env] [--format json]
+    Run comprehensive diagnostics on the config.
+
+mcp-config init [--with <servers...>] [--force]
+    Create a new .mcp.json config file.
+```
+
+Global options: `--config <path>`, `--format human|json`, `--quiet`, `--version`, `--help`.
+
+## License
+
+MIT

package/dist/__tests__/config/load.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=load.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/config/load.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/config/load.test.js

@@ -0,0 +1,142 @@
+"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 load_1 = require("../../config/load");
+const errors_1 = require("../../utils/errors");
+function makeTmpDir() {
+    const dir = (0, path_1.join)((0, os_1.tmpdir)(), `mcp-config-test-${(0, crypto_1.randomUUID)()}`);
+    (0, fs_1.mkdirSync)(dir, { recursive: true });
+    return dir;
+}
+(0, vitest_1.describe)('loadConfig', () => {
+    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 tmpDir() {
+        const d = makeTmpDir();
+        dirs.push(d);
+        return d;
+    }
+    (0, vitest_1.it)('throws ConfigNotFoundError when file does not exist', () => {
+        const dir = tmpDir();
+        (0, vitest_1.expect)(() => (0, load_1.loadConfig)((0, path_1.join)(dir, 'nonexistent.json'))).toThrow(errors_1.ConfigNotFoundError);
+    });
+    (0, vitest_1.it)('throws ConfigParseError for invalid JSON', () => {
+        const dir = tmpDir();
+        const file = (0, path_1.join)(dir, '.mcp.json');
+        (0, fs_1.writeFileSync)(file, '{ this is not valid json }');
+        (0, vitest_1.expect)(() => (0, load_1.loadConfig)(file)).toThrow(errors_1.ConfigParseError);
+    });
+    (0, vitest_1.it)('loads a valid stdio-only config', () => {
+        const dir = tmpDir();
+        const file = (0, path_1.join)(dir, '.mcp.json');
+        (0, fs_1.writeFileSync)(file, JSON.stringify({
+            mcpServers: {
+                filesystem: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-filesystem', '/tmp'] },
+            },
+        }));
+        const config = (0, load_1.loadConfig)(file);
+        (0, vitest_1.expect)(config.filePath).toBe(file);
+        (0, vitest_1.expect)(config.servers.filesystem).toBeDefined();
+        (0, vitest_1.expect)(config.servers.filesystem.type).toBe('stdio');
+    });
+    (0, vitest_1.it)('parses stdio entry fields correctly', () => {
+        const dir = tmpDir();
+        const file = (0, path_1.join)(dir, '.mcp.json');
+        (0, fs_1.writeFileSync)(file, JSON.stringify({
+            mcpServers: {
+                github: {
+                    command: 'npx',
+                    args: ['-y', '@modelcontextprotocol/server-github'],
+                    env: { GITHUB_TOKEN: 'ghp_test' },
+                    cwd: '/home/user',
+                    disabled: true,
+                },
+            },
+        }));
+        const config = (0, load_1.loadConfig)(file);
+        const entry = config.servers.github;
+        (0, vitest_1.expect)(entry.type).toBe('stdio');
+        if (entry.type === 'stdio') {
+            (0, vitest_1.expect)(entry.command).toBe('npx');
+            (0, vitest_1.expect)(entry.args).toEqual(['-y', '@modelcontextprotocol/server-github']);
+            (0, vitest_1.expect)(entry.env).toEqual({ GITHUB_TOKEN: 'ghp_test' });
+            (0, vitest_1.expect)(entry.cwd).toBe('/home/user');
+            (0, vitest_1.expect)(entry.disabled).toBe(true);
+        }
+    });
+    (0, vitest_1.it)('parses http entry fields correctly', () => {
+        const dir = tmpDir();
+        const file = (0, path_1.join)(dir, '.mcp.json');
+        (0, fs_1.writeFileSync)(file, JSON.stringify({
+            mcpServers: {
+                remote: {
+                    url: 'https://mcp.example.com/api',
+                    headers: { Authorization: 'Bearer token' },
+                    disabled: false,
+                },
+            },
+        }));
+        const config = (0, load_1.loadConfig)(file);
+        const entry = config.servers.remote;
+        (0, vitest_1.expect)(entry.type).toBe('http');
+        if (entry.type === 'http') {
+            (0, vitest_1.expect)(entry.url).toBe('https://mcp.example.com/api');
+            (0, vitest_1.expect)(entry.headers).toEqual({ Authorization: 'Bearer token' });
+            (0, vitest_1.expect)(entry.disabled).toBe(false);
+        }
+    });
+    (0, vitest_1.it)('handles mixed stdio and http entries', () => {
+        const dir = tmpDir();
+        const file = (0, path_1.join)(dir, '.mcp.json');
+        (0, fs_1.writeFileSync)(file, JSON.stringify({
+            mcpServers: {
+                local: { command: 'node', args: ['server.js'] },
+                remote: { url: 'https://mcp.example.com/api' },
+            },
+        }));
+        const config = (0, load_1.loadConfig)(file);
+        (0, vitest_1.expect)(config.servers.local.type).toBe('stdio');
+        (0, vitest_1.expect)(config.servers.remote.type).toBe('http');
+    });
+    (0, vitest_1.it)('preserves _otherKeys from the raw JSON', () => {
+        const dir = tmpDir();
+        const file = (0, path_1.join)(dir, '.mcp.json');
+        (0, fs_1.writeFileSync)(file, JSON.stringify({
+            mcpServers: {},
+            someOtherSetting: true,
+            version: 2,
+        }));
+        const config = (0, load_1.loadConfig)(file);
+        (0, vitest_1.expect)(config._otherKeys).toBeDefined();
+        (0, vitest_1.expect)(config._otherKeys?.someOtherSetting).toBe(true);
+        (0, vitest_1.expect)(config._otherKeys?.version).toBe(2);
+    });
+    (0, vitest_1.it)('does not set _otherKeys when only mcpServers key is present', () => {
+        const dir = tmpDir();
+        const file = (0, path_1.join)(dir, '.mcp.json');
+        (0, fs_1.writeFileSync)(file, JSON.stringify({ mcpServers: {} }));
+        const config = (0, load_1.loadConfig)(file);
+        (0, vitest_1.expect)(config._otherKeys).toBeUndefined();
+    });
+    (0, vitest_1.it)('loads an empty servers object when mcpServers is missing', () => {
+        const dir = tmpDir();
+        const file = (0, path_1.join)(dir, '.mcp.json');
+        (0, fs_1.writeFileSync)(file, JSON.stringify({ other: 'data' }));
+        const config = (0, load_1.loadConfig)(file);
+        (0, vitest_1.expect)(config.servers).toEqual({});
+        (0, vitest_1.expect)(config._otherKeys?.other).toBe('data');
+    });
+});
+//# sourceMappingURL=load.test.js.map

package/dist/__tests__/config/load.test.js.map

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

package/dist/__tests__/config/manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=manager.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/config/manager.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/config/manager.test.js

@@ -0,0 +1,133 @@
+"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 manager_1 = require("../../config/manager");
+const errors_1 = require("../../utils/errors");
+function makeTmpDir() {
+    const dir = (0, path_1.join)((0, os_1.tmpdir)(), `mcp-config-test-${(0, crypto_1.randomUUID)()}`);
+    (0, fs_1.mkdirSync)(dir, { recursive: true });
+    return dir;
+}
+(0, vitest_1.describe)('createManager', () => {
+    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 makeConfigFile(content) {
+        const dir = makeTmpDir();
+        dirs.push(dir);
+        const file = (0, path_1.join)(dir, '.mcp.json');
+        (0, fs_1.writeFileSync)(file, JSON.stringify(content));
+        return file;
+    }
+    (0, vitest_1.it)('throws before load is called', () => {
+        const file = makeConfigFile({ mcpServers: {} });
+        const manager = (0, manager_1.createManager)({ configPath: file });
+        (0, vitest_1.expect)(() => manager.getConfig()).toThrow();
+    });
+    (0, vitest_1.it)('load() populates the config', async () => {
+        const file = makeConfigFile({ mcpServers: { myserver: { command: 'node' } } });
+        const manager = (0, manager_1.createManager)({ configPath: file });
+        await manager.load();
+        const config = manager.getConfig();
+        (0, vitest_1.expect)(config.servers).toHaveProperty('myserver');
+    });
+    (0, vitest_1.it)('list() returns sorted server names', async () => {
+        const file = makeConfigFile({
+            mcpServers: {
+                zebra: { command: 'z' },
+                alpha: { command: 'a' },
+                mango: { url: 'https://example.com' },
+            },
+        });
+        const manager = (0, manager_1.createManager)({ configPath: file });
+        await manager.load();
+        (0, vitest_1.expect)(manager.list()).toEqual(['alpha', 'mango', 'zebra']);
+    });
+    (0, vitest_1.it)('get() returns the server entry', async () => {
+        const file = makeConfigFile({ mcpServers: { myserver: { command: 'node' } } });
+        const manager = (0, manager_1.createManager)({ configPath: file });
+        await manager.load();
+        const entry = manager.get('myserver');
+        (0, vitest_1.expect)(entry).toBeDefined();
+        (0, vitest_1.expect)(entry?.type).toBe('stdio');
+    });
+    (0, vitest_1.it)('get() returns undefined for unknown server', async () => {
+        const file = makeConfigFile({ mcpServers: {} });
+        const manager = (0, manager_1.createManager)({ configPath: file });
+        await manager.load();
+        (0, vitest_1.expect)(manager.get('nonexistent')).toBeUndefined();
+    });
+    (0, vitest_1.it)('has() returns true for existing server', async () => {
+        const file = makeConfigFile({ mcpServers: { s: { command: 'node' } } });
+        const manager = (0, manager_1.createManager)({ configPath: file });
+        await manager.load();
+        (0, vitest_1.expect)(manager.has('s')).toBe(true);
+    });
+    (0, vitest_1.it)('has() returns false for missing server', async () => {
+        const file = makeConfigFile({ mcpServers: {} });
+        const manager = (0, manager_1.createManager)({ configPath: file });
+        await manager.load();
+        (0, vitest_1.expect)(manager.has('missing')).toBe(false);
+    });
+    (0, vitest_1.it)('add() adds a new server', async () => {
+        const file = makeConfigFile({ mcpServers: {} });
+        const manager = (0, manager_1.createManager)({ configPath: file });
+        await manager.load();
+        manager.add('newserver', { type: 'stdio', command: 'npx' });
+        (0, vitest_1.expect)(manager.has('newserver')).toBe(true);
+        (0, vitest_1.expect)(manager.get('newserver')?.type).toBe('stdio');
+    });
+    (0, vitest_1.it)('add() throws ServerExistsError if server already exists', async () => {
+        const file = makeConfigFile({ mcpServers: { existing: { command: 'node' } } });
+        const manager = (0, manager_1.createManager)({ configPath: file });
+        await manager.load();
+        (0, vitest_1.expect)(() => manager.add('existing', { type: 'stdio', command: 'node' })).toThrow(errors_1.ServerExistsError);
+    });
+    (0, vitest_1.it)('remove() removes an existing server', async () => {
+        const file = makeConfigFile({ mcpServers: { toremove: { command: 'node' } } });
+        const manager = (0, manager_1.createManager)({ configPath: file });
+        await manager.load();
+        manager.remove('toremove');
+        (0, vitest_1.expect)(manager.has('toremove')).toBe(false);
+        (0, vitest_1.expect)(manager.list()).toHaveLength(0);
+    });
+    (0, vitest_1.it)('remove() throws ServerNotFoundError if server does not exist', async () => {
+        const file = makeConfigFile({ mcpServers: {} });
+        const manager = (0, manager_1.createManager)({ configPath: file });
+        await manager.load();
+        (0, vitest_1.expect)(() => manager.remove('missing')).toThrow(errors_1.ServerNotFoundError);
+    });
+    (0, vitest_1.it)('save() persists mutations to disk', async () => {
+        const file = makeConfigFile({ mcpServers: {} });
+        const manager = (0, manager_1.createManager)({ configPath: file });
+        await manager.load();
+        manager.add('saved-server', { type: 'http', url: 'https://example.com' });
+        await manager.save();
+        // Reload from disk with a new manager
+        const manager2 = (0, manager_1.createManager)({ configPath: file });
+        await manager2.load();
+        (0, vitest_1.expect)(manager2.has('saved-server')).toBe(true);
+        (0, vitest_1.expect)(manager2.get('saved-server')?.type).toBe('http');
+    });
+    (0, vitest_1.it)('validate() returns a ValidationResult', async () => {
+        const file = makeConfigFile({ mcpServers: { s: { command: 'node' } } });
+        const manager = (0, manager_1.createManager)({ configPath: file });
+        await manager.load();
+        const result = await manager.validate({ level: 3 });
+        (0, vitest_1.expect)(result.valid).toBeDefined();
+        (0, vitest_1.expect)(result.checks).toBeDefined();
+        (0, vitest_1.expect)(result.completenessScore).toBeGreaterThanOrEqual(0);
+    });
+});
+//# sourceMappingURL=manager.test.js.map

package/dist/__tests__/config/manager.test.js.map

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

package/dist/__tests__/config/save.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=save.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"save.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/config/save.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/config/save.test.js

@@ -0,0 +1,120 @@
+"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 load_1 = require("../../config/load");
+const save_1 = require("../../config/save");
+const fs_2 = require("fs");
+function makeTmpDir() {
+    const dir = (0, path_1.join)((0, os_1.tmpdir)(), `mcp-config-test-${(0, crypto_1.randomUUID)()}`);
+    (0, fs_1.mkdirSync)(dir, { recursive: true });
+    return dir;
+}
+(0, vitest_1.describe)('saveConfig', () => {
+    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 tmpDir() {
+        const d = makeTmpDir();
+        dirs.push(d);
+        return d;
+    }
+    (0, vitest_1.it)('writes valid JSON with mcpServers key', () => {
+        const dir = tmpDir();
+        const file = (0, path_1.join)(dir, '.mcp.json');
+        const config = {
+            servers: { myserver: { type: 'stdio', command: 'node' } },
+            filePath: file,
+        };
+        (0, save_1.saveConfig)(config);
+        const raw = JSON.parse((0, fs_1.readFileSync)(file, 'utf-8'));
+        (0, vitest_1.expect)(raw).toHaveProperty('mcpServers');
+        (0, vitest_1.expect)(raw.mcpServers).toHaveProperty('myserver');
+    });
+    (0, vitest_1.it)('strips the type field from saved entries', () => {
+        const dir = tmpDir();
+        const file = (0, path_1.join)(dir, '.mcp.json');
+        const config = {
+            servers: { myserver: { type: 'stdio', command: 'node' } },
+            filePath: file,
+        };
+        (0, save_1.saveConfig)(config);
+        const raw = JSON.parse((0, fs_1.readFileSync)(file, 'utf-8'));
+        (0, vitest_1.expect)(raw.mcpServers.myserver).not.toHaveProperty('type');
+        (0, vitest_1.expect)(raw.mcpServers.myserver.command).toBe('node');
+    });
+    (0, vitest_1.it)('strips type from http entries too', () => {
+        const dir = tmpDir();
+        const file = (0, path_1.join)(dir, '.mcp.json');
+        const config = {
+            servers: { remote: { type: 'http', url: 'https://example.com' } },
+            filePath: file,
+        };
+        (0, save_1.saveConfig)(config);
+        const raw = JSON.parse((0, fs_1.readFileSync)(file, 'utf-8'));
+        (0, vitest_1.expect)(raw.mcpServers.remote).not.toHaveProperty('type');
+        (0, vitest_1.expect)(raw.mcpServers.remote.url).toBe('https://example.com');
+    });
+    (0, vitest_1.it)('round-trips a config: load → modify → save → reload', () => {
+        const dir = tmpDir();
+        const file = (0, path_1.join)(dir, '.mcp.json');
+        (0, fs_2.writeFileSync)(file, JSON.stringify({
+            mcpServers: {
+                github: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-github'] },
+            },
+        }));
+        const config = (0, load_1.loadConfig)(file);
+        config.servers.newserver = { type: 'http', url: 'https://new.example.com' };
+        (0, save_1.saveConfig)(config);
+        const reloaded = (0, load_1.loadConfig)(file);
+        (0, vitest_1.expect)(Object.keys(reloaded.servers)).toHaveLength(2);
+        (0, vitest_1.expect)(reloaded.servers.github.type).toBe('stdio');
+        (0, vitest_1.expect)(reloaded.servers.newserver.type).toBe('http');
+    });
+    (0, vitest_1.it)('preserves _otherKeys on round-trip', () => {
+        const dir = tmpDir();
+        const file = (0, path_1.join)(dir, '.mcp.json');
+        (0, fs_2.writeFileSync)(file, JSON.stringify({
+            mcpServers: {},
+            extraSetting: 'preserved',
+        }));
+        const config = (0, load_1.loadConfig)(file);
+        (0, save_1.saveConfig)(config);
+        const raw = JSON.parse((0, fs_1.readFileSync)(file, 'utf-8'));
+        (0, vitest_1.expect)(raw.extraSetting).toBe('preserved');
+    });
+    (0, vitest_1.it)('creates parent directories if they do not exist', () => {
+        const dir = tmpDir();
+        const file = (0, path_1.join)(dir, 'deep', 'nested', 'dir', '.mcp.json');
+        const config = {
+            servers: {},
+            filePath: file,
+        };
+        (0, vitest_1.expect)(() => (0, save_1.saveConfig)(config)).not.toThrow();
+        const raw = JSON.parse((0, fs_1.readFileSync)(file, 'utf-8'));
+        (0, vitest_1.expect)(raw).toHaveProperty('mcpServers');
+    });
+    (0, vitest_1.it)('writes JSON with 2-space indent and trailing newline', () => {
+        const dir = tmpDir();
+        const file = (0, path_1.join)(dir, '.mcp.json');
+        const config = {
+            servers: { s: { type: 'stdio', command: 'node' } },
+            filePath: file,
+        };
+        (0, save_1.saveConfig)(config);
+        const raw = (0, fs_1.readFileSync)(file, 'utf-8');
+        (0, vitest_1.expect)(raw.endsWith('\n')).toBe(true);
+        (0, vitest_1.expect)(raw).toContain('  ');
+    });
+});
+//# sourceMappingURL=save.test.js.map

package/dist/__tests__/config/save.test.js.map

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

package/dist/__tests__/fixtures/fixtures.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fixtures.test.d.ts.map

package/dist/__tests__/fixtures/fixtures.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/fixtures.test.ts"],"names":[],"mappings":""}