mcp-doctor 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,129 @@
+# mcp-doctor
+
+Diagnose and fix MCP configuration issues across Claude Desktop, Cursor, VS Code, Claude Code, and more.
+
+## The Problem
+
+MCP configuration is fragile:
+
+- **Trailing commas** break JSON parsing silently
+- **Wrong paths** cause "server not found" errors
+- **Missing environment variables** lead to auth failures
+- **Server crashes** happen with unhelpful error messages
+
+You end up spending hours debugging issues that should take seconds to find.
+
+## The Solution
+
+```bash
+npm install -g mcp-doctor
+mcp-doctor
+```
+
+That's it. It scans your configs and tells you exactly what's wrong:
+
+```
+🩺 MCP Doctor
+
+Found 2 config files:
+
+  Claude Desktop
+  ~/Library/Application Support/Claude/claude_desktop_config.json
+
+  Cursor (project)
+  ./.cursor/mcp.json
+
+❌ 1 Error
+
+  ~/.cursor/mcp.json:12
+  Trailing comma detected (not allowed in JSON)
+  💡 Remove the comma before the closing bracket/brace
+
+⚠️  2 Warnings
+
+  ~/.cursor/mcp.json
+  Server "github": Environment variable GITHUB_TOKEN is not set
+  💡 Set it with: export GITHUB_TOKEN="your-value"
+
+  ~/.cursor/mcp.json
+  Server "myserver": Using relative path "./server.js"
+  💡 Consider using absolute path: /Users/you/project/server.js
+
+🔌 Server Health: 3 healthy, 1 failed
+
+  ✓ filesystem (120ms)
+  ✓ fetch (89ms)
+  ✓ github (340ms)
+  ✗ broken-server
+    Timeout after 10000ms
+
+──────────────────────────────────────────────────
+
+❌ Found 1 error that needs fixing
+⚠️  3/4 servers responding
+```
+
+## What It Checks
+
+| Check                     | Description                                             |
+| ------------------------- | ------------------------------------------------------- |
+| **JSON Syntax**           | Catches trailing commas, missing brackets, invalid JSON |
+| **Path Validation**       | Verifies command paths exist and are executable         |
+| **Environment Variables** | Detects missing or empty env vars                       |
+| **Hardcoded Secrets**     | Warns about API keys in config files                    |
+| **Server Health**         | Actually starts each server and tests MCP handshake     |
+
+## Supported Clients
+
+- ✅ Claude Desktop (macOS, Windows, Linux)
+- ✅ Cursor
+- ✅ VS Code (with MCP extension)
+- ✅ Claude Code
+- ✅ Windsurf
+
+## Usage
+
+```bash
+# Check all configs (default)
+mcp-doctor
+
+# Same as above
+mcp-doctor check
+
+# Skip server health tests (faster)
+mcp-doctor check --skip-health
+```
+
+## Installation
+
+Requires Node.js 18 or later.
+
+```bash
+# npm
+npm install -g mcp-doctor
+
+# Or run directly with npx
+npx mcp-doctor
+```
+
+## FAQ
+
+**Q: It says "No MCP configuration files found"**
+
+Make sure you have at least one MCP client configured. The tool looks in standard locations for each client.
+
+**Q: Server health check is timing out**
+
+Some servers take longer to start. The default timeout is 10 seconds. If your server needs more time, it might indicate a performance issue.
+
+**Q: Can it auto-fix issues?**
+
+Not yet. For now it tells you what's wrong and how to fix it. Auto-fix for simple issues (like trailing commas) is planned.
+
+## Contributing
+
+Issues and PRs welcome! https://github.com/Crooj026/mcp-doctor
+
+## License
+
+MIT

package/dist/cli/commands/check.d.ts

@@ -0,0 +1,5 @@
+interface CheckOptions {
+    skipHealth?: boolean;
+}
+export declare function checkCommand(options?: CheckOptions): Promise<void>;
+export {};

package/dist/cli/commands/check.js

@@ -0,0 +1,67 @@
+import ora from 'ora';
+import { getConfigLocations } from '../../config/locations.js';
+import { validateJsonSyntax, validatePaths, validateEnvVars, testServerHealth, } from '../../validators/index.js';
+import { printHeader, printConfigsFound, printValidationResults, printServerResults, printSummary, } from '../../utils/output.js';
+export async function checkCommand(options = {}) {
+    printHeader('🩺 MCP Doctor');
+    const spinner = ora('Scanning for MCP configurations...').start();
+    // Find all config files
+    const locations = getConfigLocations();
+    const foundConfigs = locations.filter((l) => l.exists);
+    spinner.stop();
+    // Show what we found
+    printConfigsFound(locations);
+    if (foundConfigs.length === 0) {
+        process.exitCode = 0;
+        return;
+    }
+    // Run validators on each config
+    const allResults = [];
+    const allServerResults = [];
+    const configsWithServers = [];
+    for (const configLoc of foundConfigs) {
+        // JSON syntax check
+        const { valid, results: syntaxResults, config } = validateJsonSyntax(configLoc.path);
+        allResults.push(...syntaxResults);
+        // If JSON is invalid, skip other validators for this file
+        if (!valid || !config) {
+            continue;
+        }
+        // Store for server health testing
+        configsWithServers.push({ path: configLoc.path, config });
+        // Path validation
+        allResults.push(...validatePaths(config, configLoc.path));
+        // Environment variable validation
+        allResults.push(...validateEnvVars(config, configLoc.path));
+    }
+    // Print validation results
+    printValidationResults(allResults);
+    // Server health tests (unless skipped)
+    if (!options.skipHealth && configsWithServers.length > 0) {
+        const healthSpinner = ora('Testing server connectivity...').start();
+        for (const { config } of configsWithServers) {
+            const results = await testServerHealth(config);
+            allServerResults.push(...results);
+        }
+        healthSpinner.stop();
+        // Deduplicate servers by name (same server might be in multiple configs)
+        const uniqueServers = new Map();
+        for (const result of allServerResults) {
+            // Keep the healthy result if we have conflicting results
+            if (!uniqueServers.has(result.name) || result.healthy) {
+                uniqueServers.set(result.name, result);
+            }
+        }
+        printServerResults(Array.from(uniqueServers.values()));
+    }
+    // Summary
+    const errors = allResults.filter((r) => r.level === 'error').length;
+    const warnings = allResults.filter((r) => r.level === 'warning').length;
+    const healthyServers = allServerResults.filter((s) => s.healthy).length;
+    printSummary(errors, warnings, healthyServers, allServerResults.length);
+    // Set exit code
+    if (errors > 0) {
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/cli/commands/check.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { checkCommand } from './commands/check.js';
+const program = new Command();
+program
+    .name('mcp-doctor')
+    .description('Diagnose and fix MCP configuration issues')
+    .version('0.1.0');
+program
+    .command('check')
+    .description('Validate all MCP configuration files')
+    .option('--skip-health', 'Skip server health checks')
+    .action(async (options) => {
+    await checkCommand({
+        skipHealth: options.skipHealth,
+    });
+});
+// Default command (no subcommand) runs check
+program
+    .action(async () => {
+    await checkCommand();
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,2CAA2C,CAAC;KACxD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,sCAAsC,CAAC;KACnD,MAAM,CAAC,eAAe,EAAE,2BAA2B,CAAC;KACpD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IACxB,MAAM,YAAY,CAAC;QACjB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,6CAA6C;AAC7C,OAAO;KACJ,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,YAAY,EAAE,CAAC;AACvB,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/config/locations.d.ts

@@ -0,0 +1,3 @@
+import { ConfigLocation } from './types.js';
+export declare function getConfigLocations(projectDir?: string): ConfigLocation[];
+export declare function getServersFromConfig(config: Record<string, unknown>): Record<string, unknown> | null;

package/dist/config/locations.js

@@ -0,0 +1,138 @@
+import { homedir, platform } from 'os';
+import { join } from 'path';
+import { existsSync } from 'fs';
+export function getConfigLocations(projectDir) {
+    const home = homedir();
+    const os = platform();
+    const cwd = projectDir || process.cwd();
+    const locations = [];
+    // ============================================
+    // Claude Desktop
+    // ============================================
+    if (os === 'darwin') {
+        locations.push({
+            client: 'Claude Desktop',
+            scope: 'global',
+            path: join(home, 'Library/Application Support/Claude/claude_desktop_config.json'),
+        });
+    }
+    else if (os === 'win32') {
+        locations.push({
+            client: 'Claude Desktop',
+            scope: 'global',
+            path: join(process.env.APPDATA || join(home, 'AppData/Roaming'), 'Claude/claude_desktop_config.json'),
+        });
+    }
+    else {
+        // Linux
+        locations.push({
+            client: 'Claude Desktop',
+            scope: 'global',
+            path: join(home, '.config/claude/claude_desktop_config.json'),
+        });
+    }
+    // ============================================
+    // Claude Code
+    // ============================================
+    locations.push({
+        client: 'Claude Code',
+        scope: 'global',
+        path: join(home, '.claude.json'),
+    });
+    locations.push({
+        client: 'Claude Code',
+        scope: 'project',
+        path: join(cwd, '.mcp.json'),
+    });
+    // ============================================
+    // Cursor
+    // ============================================
+    if (os === 'darwin') {
+        locations.push({
+            client: 'Cursor',
+            scope: 'global',
+            path: join(home, 'Library/Application Support/Cursor/User/globalStorage/cursor.mcp/mcp.json'),
+        });
+    }
+    else if (os === 'win32') {
+        locations.push({
+            client: 'Cursor',
+            scope: 'global',
+            path: join(process.env.APPDATA || join(home, 'AppData/Roaming'), 'Cursor/User/globalStorage/cursor.mcp/mcp.json'),
+        });
+    }
+    else {
+        locations.push({
+            client: 'Cursor',
+            scope: 'global',
+            path: join(home, '.config/Cursor/User/globalStorage/cursor.mcp/mcp.json'),
+        });
+    }
+    // Also check older Cursor location
+    locations.push({
+        client: 'Cursor',
+        scope: 'global',
+        path: join(home, '.cursor/mcp.json'),
+    });
+    locations.push({
+        client: 'Cursor',
+        scope: 'project',
+        path: join(cwd, '.cursor/mcp.json'),
+    });
+    // ============================================
+    // VS Code (MCP extension)
+    // ============================================
+    if (os === 'darwin') {
+        locations.push({
+            client: 'VS Code',
+            scope: 'global',
+            path: join(home, 'Library/Application Support/Code/User/settings.json'),
+        });
+    }
+    else if (os === 'win32') {
+        locations.push({
+            client: 'VS Code',
+            scope: 'global',
+            path: join(process.env.APPDATA || join(home, 'AppData/Roaming'), 'Code/User/settings.json'),
+        });
+    }
+    else {
+        locations.push({
+            client: 'VS Code',
+            scope: 'global',
+            path: join(home, '.config/Code/User/settings.json'),
+        });
+    }
+    locations.push({
+        client: 'VS Code',
+        scope: 'project',
+        path: join(cwd, '.vscode/settings.json'),
+    });
+    // ============================================
+    // Windsurf
+    // ============================================
+    locations.push({
+        client: 'Windsurf',
+        scope: 'global',
+        path: join(home, '.codeium/windsurf/mcp_config.json'),
+    });
+    // Check existence and return
+    return locations.map((loc) => ({
+        ...loc,
+        exists: existsSync(loc.path),
+    }));
+}
+export function getServersFromConfig(config) {
+    // Try different config formats
+    if (config.mcpServers && typeof config.mcpServers === 'object') {
+        return config.mcpServers;
+    }
+    if (config['mcp.servers'] && typeof config['mcp.servers'] === 'object') {
+        return config['mcp.servers'];
+    }
+    if (config.servers && typeof config.servers === 'object') {
+        return config.servers;
+    }
+    return null;
+}
+//# sourceMappingURL=locations.js.map

package/dist/config/locations.js.map

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

package/dist/config/types.d.ts

@@ -0,0 +1,37 @@
+export interface MCPServerConfig {
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+    url?: string;
+}
+export interface MCPConfig {
+    mcpServers?: Record<string, MCPServerConfig>;
+    'mcp.servers'?: Record<string, MCPServerConfig>;
+    servers?: Record<string, MCPServerConfig>;
+}
+export interface ConfigLocation {
+    client: string;
+    scope: 'global' | 'project';
+    path: string;
+    exists: boolean;
+}
+export interface ValidationResult {
+    level: 'error' | 'warning' | 'info';
+    code: string;
+    message: string;
+    file: string;
+    line?: number;
+    suggestion?: string;
+}
+export interface ServerTestResult {
+    name: string;
+    healthy: boolean;
+    responseTime?: number;
+    error?: string;
+}
+export interface CheckResults {
+    configsFound: ConfigLocation[];
+    validationResults: ValidationResult[];
+    serverResults: ServerTestResult[];
+}

package/dist/config/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/config/types.js.map

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

package/dist/utils/output.d.ts

@@ -0,0 +1,6 @@
+import { ValidationResult, ServerTestResult, ConfigLocation } from '../config/types.js';
+export declare function printHeader(text: string): void;
+export declare function printConfigsFound(configs: ConfigLocation[]): void;
+export declare function printValidationResults(results: ValidationResult[]): void;
+export declare function printServerResults(results: ServerTestResult[]): void;
+export declare function printSummary(errors: number, warnings: number, healthyServers: number, totalServers: number): void;

package/dist/utils/output.js

@@ -0,0 +1,102 @@
+import chalk from 'chalk';
+export function printHeader(text) {
+    console.log(chalk.bold(`\n${text}\n`));
+}
+export function printConfigsFound(configs) {
+    const found = configs.filter((c) => c.exists);
+    const notFound = configs.filter((c) => !c.exists);
+    if (found.length === 0) {
+        console.log(chalk.yellow('No MCP configuration files found.\n'));
+        console.log(chalk.gray('Looked in:'));
+        notFound.slice(0, 5).forEach((c) => {
+            console.log(chalk.gray(`  ${c.client}: ${c.path}`));
+        });
+        if (notFound.length > 5) {
+            console.log(chalk.gray(`  ... and ${notFound.length - 5} more locations`));
+        }
+        return;
+    }
+    console.log(chalk.green(`Found ${found.length} config file${found.length > 1 ? 's' : ''}:\n`));
+    found.forEach((c) => {
+        const scope = c.scope === 'project' ? chalk.gray(' (project)') : '';
+        console.log(`  ${chalk.cyan(c.client)}${scope}`);
+        console.log(chalk.gray(`  ${c.path}\n`));
+    });
+}
+export function printValidationResults(results) {
+    const errors = results.filter((r) => r.level === 'error');
+    const warnings = results.filter((r) => r.level === 'warning');
+    if (errors.length > 0) {
+        console.log(chalk.red(`❌ ${errors.length} Error${errors.length > 1 ? 's' : ''}\n`));
+        errors.forEach((e) => {
+            const location = e.line ? `:${e.line}` : '';
+            console.log(chalk.red(`  ${shortPath(e.file)}${location}`));
+            console.log(chalk.red(`  ${e.message}`));
+            if (e.suggestion) {
+                console.log(chalk.gray(`  💡 ${e.suggestion}`));
+            }
+            console.log('');
+        });
+    }
+    if (warnings.length > 0) {
+        console.log(chalk.yellow(`⚠️  ${warnings.length} Warning${warnings.length > 1 ? 's' : ''}\n`));
+        warnings.forEach((w) => {
+            const location = w.line ? `:${w.line}` : '';
+            console.log(chalk.yellow(`  ${shortPath(w.file)}${location}`));
+            console.log(chalk.yellow(`  ${w.message}`));
+            if (w.suggestion) {
+                console.log(chalk.gray(`  💡 ${w.suggestion}`));
+            }
+            console.log('');
+        });
+    }
+}
+export function printServerResults(results) {
+    if (results.length === 0) {
+        console.log(chalk.gray('No servers to test.\n'));
+        return;
+    }
+    const healthy = results.filter((s) => s.healthy);
+    const unhealthy = results.filter((s) => !s.healthy);
+    console.log(`🔌 Server Health: ${chalk.green(healthy.length)} healthy, ${unhealthy.length > 0 ? chalk.red(unhealthy.length + ' failed') : chalk.gray('0 failed')}\n`);
+    healthy.forEach((s) => {
+        const time = s.responseTime ? chalk.gray(` (${s.responseTime}ms)`) : '';
+        console.log(chalk.green(`  ✓ ${s.name}${time}`));
+    });
+    unhealthy.forEach((s) => {
+        console.log(chalk.red(`  ✗ ${s.name}`));
+        if (s.error) {
+            console.log(chalk.gray(`    ${s.error}`));
+        }
+    });
+    console.log('');
+}
+export function printSummary(errors, warnings, healthyServers, totalServers) {
+    console.log(chalk.gray('─'.repeat(50)));
+    if (errors === 0 && warnings === 0) {
+        console.log(chalk.green('\n✓ All configurations valid'));
+    }
+    else if (errors === 0) {
+        console.log(chalk.yellow(`\n⚠️  Configuration valid with ${warnings} warning${warnings > 1 ? 's' : ''}`));
+    }
+    else {
+        console.log(chalk.red(`\n❌ Found ${errors} error${errors > 1 ? 's' : ''} that need${errors === 1 ? 's' : ''} fixing`));
+    }
+    if (totalServers > 0) {
+        if (healthyServers === totalServers) {
+            console.log(chalk.green(`✓ All ${totalServers} server${totalServers > 1 ? 's' : ''} responding`));
+        }
+        else {
+            console.log(chalk.yellow(`⚠️  ${healthyServers}/${totalServers} servers responding`));
+        }
+    }
+    console.log('');
+}
+function shortPath(path) {
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    if (home && path.startsWith(home)) {
+        return '~' + path.slice(home.length);
+    }
+    return path;
+}
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

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

package/dist/validators/env-vars.d.ts

@@ -0,0 +1,2 @@
+import { ValidationResult } from '../config/types.js';
+export declare function validateEnvVars(config: Record<string, unknown>, configPath: string): ValidationResult[];

package/dist/validators/env-vars.js

@@ -0,0 +1,70 @@
+import { getServersFromConfig } from '../config/locations.js';
+export function validateEnvVars(config, configPath) {
+    const results = [];
+    const servers = getServersFromConfig(config);
+    if (!servers) {
+        return results;
+    }
+    for (const [name, serverRaw] of Object.entries(servers)) {
+        const server = serverRaw;
+        if (!server.env)
+            continue;
+        for (const [key, value] of Object.entries(server.env)) {
+            if (typeof value !== 'string')
+                continue;
+            // Check for ${VAR} or $VAR references
+            const varRefs = value.match(/\$\{([A-Z_][A-Z0-9_]*)\}|\$([A-Z_][A-Z0-9_]*)/g) || [];
+            for (const ref of varRefs) {
+                const varName = ref.replace(/^\$\{?|\}?$/g, '');
+                if (!process.env[varName]) {
+                    results.push({
+                        level: 'warning',
+                        code: 'ENV_VAR_MISSING',
+                        message: `Server "${name}": Environment variable ${varName} is not set`,
+                        file: configPath,
+                        suggestion: `Set it with: export ${varName}="your-value"`,
+                    });
+                }
+            }
+            // Check for empty values that look like they should be set
+            if (value === '' || value === '""' || value === "''") {
+                results.push({
+                    level: 'warning',
+                    code: 'ENV_VAR_EMPTY',
+                    message: `Server "${name}": Environment variable ${key} is empty`,
+                    file: configPath,
+                    suggestion: 'This may cause authentication or configuration issues',
+                });
+            }
+            // Warn about hardcoded secrets
+            const secretKeyPatterns = [
+                /^(api[_-]?key|secret|token|password|pwd|auth|credential)/i,
+                /_(api[_-]?key|secret|token|password|pwd|auth|credential)$/i,
+            ];
+            const secretValuePatterns = [
+                /^sk[-_][a-zA-Z0-9]{20,}$/, // OpenAI-style keys
+                /^[a-f0-9]{32,}$/i, // Hex strings (32+ chars)
+                /^eyJ[a-zA-Z0-9_-]+\.[a-zA-Z0-9_-]+/, // JWT tokens
+                /^ghp_[a-zA-Z0-9]{36}$/, // GitHub tokens
+                /^github_pat_[a-zA-Z0-9_]{22,}/, // GitHub PAT
+                /^xoxb-[0-9]{10,}/, // Slack bot tokens
+                /^xoxp-[0-9]{10,}/, // Slack user tokens
+                /^AKIA[A-Z0-9]{16}$/, // AWS access keys
+            ];
+            const isSecretKey = secretKeyPatterns.some((p) => p.test(key));
+            const looksLikeSecret = secretValuePatterns.some((p) => p.test(value));
+            // Only warn if it's not a variable reference
+            if ((isSecretKey || looksLikeSecret) && !value.includes('$')) {
+                results.push({
+                    level: 'warning',
+                    code: 'HARDCODED_SECRET',
+                    message: `Server "${name}": Possible hardcoded secret in ${key}`,
+                    file: configPath,
+                    suggestion: 'Use an environment variable reference like ${' + key.toUpperCase() + '} instead',
+                });
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=env-vars.js.map