mcp-doctor 0.1.0

package/dist/validators/env-vars.js.map

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

package/dist/validators/index.d.ts

@@ -0,0 +1,4 @@
+export { validateJsonSyntax } from './json-syntax.js';
+export { validatePaths } from './paths.js';
+export { validateEnvVars } from './env-vars.js';
+export { testServerHealth } from './server-health.js';

package/dist/validators/index.js

@@ -0,0 +1,5 @@
+export { validateJsonSyntax } from './json-syntax.js';
+export { validatePaths } from './paths.js';
+export { validateEnvVars } from './env-vars.js';
+export { testServerHealth } from './server-health.js';
+//# sourceMappingURL=index.js.map

package/dist/validators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/validators/json-syntax.d.ts

@@ -0,0 +1,6 @@
+import { ValidationResult } from '../config/types.js';
+export declare function validateJsonSyntax(filePath: string): {
+    valid: boolean;
+    results: ValidationResult[];
+    config?: Record<string, unknown>;
+};

package/dist/validators/json-syntax.js

@@ -0,0 +1,77 @@
+import { readFileSync } from 'fs';
+export function validateJsonSyntax(filePath) {
+    const results = [];
+    let content;
+    try {
+        content = readFileSync(filePath, 'utf-8');
+    }
+    catch (error) {
+        results.push({
+            level: 'error',
+            code: 'FILE_READ_ERROR',
+            message: `Cannot read file: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            file: filePath,
+        });
+        return { valid: false, results };
+    }
+    // Check for empty file
+    if (!content.trim()) {
+        results.push({
+            level: 'warning',
+            code: 'EMPTY_FILE',
+            message: 'Config file is empty',
+            file: filePath,
+        });
+        return { valid: true, results, config: {} };
+    }
+    // Try to parse JSON
+    try {
+        const config = JSON.parse(content);
+        return { valid: true, results, config };
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            // Try to find the line number
+            const match = error.message.match(/position\s+(\d+)/i);
+            let line;
+            let column;
+            if (match) {
+                const position = parseInt(match[1], 10);
+                const lines = content.substring(0, position).split('\n');
+                line = lines.length;
+                column = lines[lines.length - 1].length + 1;
+            }
+            // Check for common issues
+            const trailingCommaMatch = content.match(/,\s*([}\]])/);
+            if (trailingCommaMatch) {
+                // Find line of trailing comma
+                const beforeMatch = content.substring(0, content.indexOf(trailingCommaMatch[0]));
+                const trailingCommaLine = beforeMatch.split('\n').length;
+                results.push({
+                    level: 'error',
+                    code: 'JSON_TRAILING_COMMA',
+                    message: 'Trailing comma detected (not allowed in JSON)',
+                    file: filePath,
+                    line: trailingCommaLine,
+                    suggestion: 'Remove the comma before the closing bracket/brace',
+                });
+            }
+            else {
+                // Generic JSON error
+                let message = error.message;
+                if (line && column) {
+                    message = `Invalid JSON at line ${line}, column ${column}: ${error.message}`;
+                }
+                results.push({
+                    level: 'error',
+                    code: 'JSON_SYNTAX',
+                    message,
+                    file: filePath,
+                    line,
+                });
+            }
+        }
+        return { valid: false, results };
+    }
+}
+//# sourceMappingURL=json-syntax.js.map

package/dist/validators/json-syntax.js.map

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

package/dist/validators/paths.d.ts

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

package/dist/validators/paths.js

@@ -0,0 +1,125 @@
+import { existsSync, accessSync, constants } from 'fs';
+import { isAbsolute, resolve, dirname } from 'path';
+import { getServersFromConfig } from '../config/locations.js';
+export function validatePaths(config, configPath) {
+    const results = [];
+    const servers = getServersFromConfig(config);
+    if (!servers) {
+        return results;
+    }
+    const configDir = dirname(configPath);
+    for (const [name, serverRaw] of Object.entries(servers)) {
+        const server = serverRaw;
+        // Skip HTTP/URL-based servers
+        if (server.url)
+            continue;
+        // Skip if no command specified
+        if (!server.command) {
+            results.push({
+                level: 'error',
+                code: 'MISSING_COMMAND',
+                message: `Server "${name}": No command specified`,
+                file: configPath,
+                suggestion: 'Add a "command" field specifying how to start the server',
+            });
+            continue;
+        }
+        const command = server.command;
+        // Check if command is a path (contains / or \)
+        if (command.includes('/') || command.includes('\\')) {
+            const resolvedPath = isAbsolute(command)
+                ? command
+                : resolve(configDir, command);
+            // Check existence
+            if (!existsSync(resolvedPath)) {
+                results.push({
+                    level: 'error',
+                    code: 'PATH_NOT_FOUND',
+                    message: `Server "${name}": Command path does not exist: ${command}`,
+                    file: configPath,
+                    suggestion: `Check the path is correct. Resolved to: ${resolvedPath}`,
+                });
+            }
+            else {
+                // Check executable permission (Unix only)
+                if (process.platform !== 'win32') {
+                    try {
+                        accessSync(resolvedPath, constants.X_OK);
+                    }
+                    catch {
+                        results.push({
+                            level: 'error',
+                            code: 'PATH_NOT_EXECUTABLE',
+                            message: `Server "${name}": Command is not executable: ${command}`,
+                            file: configPath,
+                            suggestion: `Run: chmod +x "${resolvedPath}"`,
+                        });
+                    }
+                }
+            }
+            // Warn about relative paths
+            if (!isAbsolute(command)) {
+                results.push({
+                    level: 'warning',
+                    code: 'PATH_RELATIVE',
+                    message: `Server "${name}": Using relative path "${command}"`,
+                    file: configPath,
+                    suggestion: `Consider using absolute path: ${resolvedPath}`,
+                });
+            }
+        }
+        else {
+            // Command is not a path (e.g., "npx", "node", "python")
+            // We can't easily validate these as they depend on PATH
+            // But we can warn if it looks like a typo
+            const commonCommands = ['npx', 'node', 'python', 'python3', 'uv', 'uvx', 'deno', 'bun'];
+            const looksLikePath = command.includes('.') && !commonCommands.includes(command);
+            if (looksLikePath) {
+                results.push({
+                    level: 'warning',
+                    code: 'POSSIBLE_PATH_TYPO',
+                    message: `Server "${name}": "${command}" looks like a filename but isn't a path`,
+                    file: configPath,
+                    suggestion: 'If this is a file, use a full path like "./server.js" or "/path/to/server.js"',
+                });
+            }
+        }
+        // Check cwd if specified
+        if (server.cwd) {
+            const cwdPath = isAbsolute(server.cwd)
+                ? server.cwd
+                : resolve(configDir, server.cwd);
+            if (!existsSync(cwdPath)) {
+                results.push({
+                    level: 'error',
+                    code: 'CWD_NOT_FOUND',
+                    message: `Server "${name}": Working directory does not exist: ${server.cwd}`,
+                    file: configPath,
+                    suggestion: `Create the directory or update the path. Resolved to: ${cwdPath}`,
+                });
+            }
+        }
+        // Check args for paths
+        if (server.args && Array.isArray(server.args)) {
+            for (const arg of server.args) {
+                // If arg looks like an absolute path, check it exists
+                if (typeof arg === 'string' && isAbsolute(arg) && (arg.includes('/') || arg.includes('\\'))) {
+                    // Only check if it looks like a file path (not a URL or flag)
+                    if (!arg.startsWith('-') && !arg.startsWith('http')) {
+                        if (!existsSync(arg)) {
+                            results.push({
+                                level: 'warning',
+                                code: 'ARG_PATH_NOT_FOUND',
+                                message: `Server "${name}": Argument path may not exist: ${arg}`,
+                                file: configPath,
+                                suggestion: 'Verify this path is correct',
+                            });
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=paths.js.map

package/dist/validators/paths.js.map

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

package/dist/validators/server-health.d.ts

@@ -0,0 +1,2 @@
+import { ServerTestResult } from '../config/types.js';
+export declare function testServerHealth(config: Record<string, unknown>, timeout?: number): Promise<ServerTestResult[]>;

package/dist/validators/server-health.js

@@ -0,0 +1,135 @@
+import { spawn } from 'child_process';
+import { getServersFromConfig } from '../config/locations.js';
+export async function testServerHealth(config, timeout = 10000) {
+    const results = [];
+    const servers = getServersFromConfig(config);
+    if (!servers) {
+        return results;
+    }
+    const testPromises = Object.entries(servers).map(async ([name, serverRaw]) => {
+        const server = serverRaw;
+        const startTime = Date.now();
+        // Skip URL-based servers for now
+        if (server.url) {
+            return {
+                name,
+                healthy: true, // Assume healthy for HTTP servers
+                responseTime: undefined,
+                error: 'HTTP servers not tested (coming soon)',
+            };
+        }
+        // Skip if no command
+        if (!server.command) {
+            return {
+                name,
+                healthy: false,
+                error: 'No command specified',
+            };
+        }
+        try {
+            const healthy = await testStdioServer(server.command, server.args || [], server.env, timeout);
+            const responseTime = Date.now() - startTime;
+            return {
+                name,
+                healthy,
+                responseTime: healthy ? responseTime : undefined,
+                error: healthy ? undefined : `Timeout after ${timeout}ms`,
+            };
+        }
+        catch (error) {
+            return {
+                name,
+                healthy: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    });
+    return Promise.all(testPromises);
+}
+async function testStdioServer(command, args, env, timeout = 10000) {
+    return new Promise((resolve) => {
+        let proc;
+        try {
+            proc = spawn(command, args, {
+                stdio: ['pipe', 'pipe', 'pipe'],
+                env: { ...process.env, ...env },
+                shell: process.platform === 'win32', // Use shell on Windows for npx etc
+            });
+        }
+        catch (error) {
+            resolve(false);
+            return;
+        }
+        const timer = setTimeout(() => {
+            proc.kill();
+            resolve(false);
+        }, timeout);
+        let buffer = '';
+        let initialized = false;
+        proc.stdout?.on('data', (data) => {
+            buffer += data.toString();
+            // Try to parse complete JSON-RPC messages
+            const lines = buffer.split('\n');
+            buffer = lines.pop() || '';
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const message = JSON.parse(line);
+                    // Handle initialize response
+                    if (message.id === 1 && message.result && !initialized) {
+                        initialized = true;
+                        clearTimeout(timer);
+                        proc.kill();
+                        resolve(true);
+                    }
+                    // Handle error response
+                    if (message.id === 1 && message.error) {
+                        clearTimeout(timer);
+                        proc.kill();
+                        resolve(false);
+                    }
+                }
+                catch {
+                    // Not valid JSON, might be partial or non-JSON output
+                }
+            }
+        });
+        proc.on('error', (error) => {
+            clearTimeout(timer);
+            // Check for common issues
+            if (error.code === 'ENOENT') {
+                // Command not found - this is expected for some setups
+            }
+            resolve(false);
+        });
+        proc.on('exit', (code) => {
+            if (!initialized) {
+                clearTimeout(timer);
+                // Non-zero exit before responding is a failure
+                if (code !== 0 && code !== null) {
+                    resolve(false);
+                }
+            }
+        });
+        // Send initialize request
+        const initRequest = JSON.stringify({
+            jsonrpc: '2.0',
+            id: 1,
+            method: 'initialize',
+            params: {
+                protocolVersion: '2024-11-05',
+                capabilities: {},
+                clientInfo: { name: 'mcp-doctor', version: '1.0.0' },
+            },
+        });
+        try {
+            proc.stdin?.write(initRequest + '\n');
+        }
+        catch {
+            clearTimeout(timer);
+            resolve(false);
+        }
+    });
+}
+//# sourceMappingURL=server-health.js.map

package/dist/validators/server-health.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "mcp-doctor",
+  "version": "0.1.0",
+  "description": "Diagnose and fix MCP configuration issues across Claude Desktop, Cursor, VS Code, and more",
+  "type": "module",
+  "bin": {
+    "mcp-doctor": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli/index.ts",
+    "start": "node dist/cli/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "cursor",
+    "vscode",
+    "debugging",
+    "cli",
+    "developer-tools",
+    "anthropic"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Crooj026/mcp-doctor"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "ora": "^8.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0"
+  }
+}

package/src/cli/commands/check.ts

@@ -0,0 +1,103 @@
+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';
+import { ValidationResult, ServerTestResult } from '../../config/types.js';
+
+interface CheckOptions {
+  skipHealth?: boolean;
+}
+
+export async function checkCommand(options: CheckOptions = {}): Promise<void> {
+  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: ValidationResult[] = [];
+  const allServerResults: ServerTestResult[] = [];
+  const configsWithServers: Array<{ path: string; config: Record<string, unknown> }> = [];
+
+  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<string, ServerTestResult>();
+    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;
+  }
+}

package/src/cli/index.ts

@@ -0,0 +1,29 @@
+#!/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();