@stacksfinder/mcp-server 1.1.0 → 1.2.1

package/dist/lib/mcp-compatibility/utils.js

@@ -0,0 +1,269 @@
+/**
+ * MCP Compatibility Utilities
+ *
+ * Canonical matching utilities for consistent MCP identification.
+ */
+/**
+ * Aliases map for common MCP name variations.
+ * Keys are normalized (lowercase, trimmed), values are canonical IDs.
+ */
+export const MCP_ALIASES = {
+    // Database MCPs
+    supabase: 'supabase-mcp',
+    '@supabase/mcp': 'supabase-mcp',
+    '@supabase/mcp-server': 'supabase-mcp',
+    neon: 'neon-mcp',
+    '@neondatabase/mcp': 'neon-mcp',
+    '@neondatabase/mcp-server': 'neon-mcp',
+    planetscale: 'planetscale-mcp',
+    '@planetscale/mcp': 'planetscale-mcp',
+    turso: 'turso-mcp',
+    '@tursodb/mcp': 'turso-mcp',
+    mongodb: 'mongodb-mcp',
+    '@mongodb/mcp': 'mongodb-mcp',
+    // ORM MCPs
+    prisma: 'prisma-mcp',
+    '@prisma/mcp': 'prisma-mcp',
+    drizzle: 'drizzle-mcp',
+    'drizzle-orm': 'drizzle-mcp',
+    typeorm: 'typeorm-mcp',
+    // Auth MCPs
+    clerk: 'clerk-mcp',
+    '@clerk/mcp': 'clerk-mcp',
+    auth0: 'auth0-mcp',
+    '@auth0/mcp': 'auth0-mcp',
+    'supabase-auth': 'supabase-auth-mcp',
+    lucia: 'lucia-mcp',
+    // Payments MCPs
+    stripe: 'stripe-mcp',
+    '@stripe/mcp': 'stripe-mcp',
+    paddle: 'paddle-mcp',
+    '@paddle/mcp': 'paddle-mcp',
+    lemonsqueezy: 'lemonsqueezy-mcp',
+    'lemon-squeezy': 'lemonsqueezy-mcp',
+    // Deployment MCPs
+    vercel: 'vercel-mcp',
+    '@vercel/mcp': 'vercel-mcp',
+    netlify: 'netlify-mcp',
+    '@netlify/mcp': 'netlify-mcp',
+    cloudflare: 'cloudflare-mcp',
+    '@cloudflare/mcp': 'cloudflare-mcp',
+    railway: 'railway-mcp',
+    fly: 'fly-mcp',
+    'fly.io': 'fly-mcp',
+    render: 'render-mcp',
+    // Storage MCPs
+    r2: 'r2-mcp',
+    'cloudflare-r2': 'r2-mcp',
+    s3: 's3-mcp',
+    'aws-s3': 's3-mcp',
+    uploadthing: 'uploadthing-mcp',
+    // Email MCPs
+    resend: 'resend-mcp',
+    '@resend/mcp': 'resend-mcp',
+    sendgrid: 'sendgrid-mcp',
+    postmark: 'postmark-mcp',
+    // Version Control MCPs
+    github: 'github-mcp',
+    '@github/mcp': 'github-mcp',
+    gitlab: 'gitlab-mcp',
+    '@gitlab/mcp': 'gitlab-mcp',
+    // AI MCPs
+    openai: 'openai-mcp',
+    '@openai/mcp': 'openai-mcp',
+    anthropic: 'anthropic-mcp',
+    '@anthropic/mcp': 'anthropic-mcp',
+    perplexity: 'perplexity-mcp',
+    context7: 'context7-mcp',
+    // Communication MCPs
+    slack: 'slack-mcp',
+    '@slack/mcp': 'slack-mcp',
+    discord: 'discord-mcp',
+    telegram: 'telegram-mcp',
+    // Monitoring MCPs
+    sentry: 'sentry-mcp',
+    '@sentry/mcp': 'sentry-mcp',
+    datadog: 'datadog-mcp',
+    // Testing MCPs
+    playwright: 'playwright-mcp',
+    '@playwright/mcp': 'playwright-mcp',
+    puppeteer: 'puppeteer-mcp',
+    // Documentation MCPs
+    obsidian: 'obsidian-mcp',
+    notion: 'notion-mcp',
+    confluence: 'confluence-mcp',
+    // General MCPs
+    filesystem: 'filesystem-mcp',
+    'sequential-thinking': 'sequential-thinking-mcp',
+    'brave-search': 'brave-search-mcp',
+};
+/**
+ * Canonicalize an MCP ID to a consistent format.
+ *
+ * @param id - The MCP ID to canonicalize (e.g., "supabase", "@supabase/mcp")
+ * @returns The canonical ID (e.g., "supabase-mcp")
+ */
+export function canonicalizeMcpId(id) {
+    const normalized = id.toLowerCase().trim();
+    return MCP_ALIASES[normalized] ?? normalized;
+}
+/**
+ * Generate a consistent pair key for two MCPs.
+ * The key is ordered alphabetically to ensure A/B and B/A produce the same key.
+ *
+ * @param a - First MCP ID
+ * @param b - Second MCP ID
+ * @returns Pair key in format "mcpA::mcpB" (alphabetically ordered)
+ */
+export function pairKey(a, b) {
+    const canonA = canonicalizeMcpId(a);
+    const canonB = canonicalizeMcpId(b);
+    const [first, second] = [canonA, canonB].sort();
+    return `${first}::${second}`;
+}
+/**
+ * Rules indexed by pair key for O(1) lookup.
+ * Populated by initRulesIndex().
+ */
+let RULES_BY_PAIR = new Map();
+/**
+ * Initialize the rules index from an array of rules.
+ * Must be called before using findRule().
+ *
+ * @param rules - Array of compatibility rules
+ */
+export function initRulesIndex(rules) {
+    RULES_BY_PAIR = new Map();
+    for (const rule of rules) {
+        const key = pairKey(rule.mcpA, rule.mcpB);
+        RULES_BY_PAIR.set(key, rule);
+    }
+}
+/**
+ * Get the rules index (for testing).
+ */
+export function getRulesIndex() {
+    return RULES_BY_PAIR;
+}
+/**
+ * Find a compatibility rule for two MCPs.
+ * Order doesn't matter: findRule(A, B) === findRule(B, A)
+ *
+ * @param a - First MCP ID (can be any alias)
+ * @param b - Second MCP ID (can be any alias)
+ * @returns The matching rule, or undefined if no rule exists
+ */
+export function findRule(a, b) {
+    const key = pairKey(a, b);
+    return RULES_BY_PAIR.get(key);
+}
+/**
+ * Generate all unique pairs from an array of MCPs.
+ * Used to check all nC2 combinations.
+ *
+ * @param mcps - Array of MCP IDs
+ * @returns Array of [mcpA, mcpB] pairs
+ */
+export function generatePairs(mcps) {
+    const pairs = [];
+    for (let i = 0; i < mcps.length; i++) {
+        for (let j = i + 1; j < mcps.length; j++) {
+            pairs.push([mcps[i], mcps[j]]);
+        }
+    }
+    return pairs;
+}
+/**
+ * Check all pairs of MCPs for compatibility issues.
+ *
+ * @param mcps - Array of MCP IDs to check
+ * @returns Object with categorized matched rules
+ */
+export function checkAllPairs(mcps) {
+    const conflicts = [];
+    const redundancies = [];
+    const synergies = [];
+    const conditionals = [];
+    const pairs = generatePairs(mcps);
+    for (const [a, b] of pairs) {
+        const rule = findRule(a, b);
+        if (rule) {
+            const matched = {
+                rule,
+                inputA: a,
+                inputB: b,
+            };
+            switch (rule.status) {
+                case 'conflict':
+                    conflicts.push(matched);
+                    break;
+                case 'redundant':
+                    redundancies.push(matched);
+                    break;
+                case 'synergy':
+                    synergies.push(matched);
+                    break;
+                case 'conditional':
+                    conditionals.push(matched);
+                    break;
+                // 'compatible' - no action needed
+            }
+        }
+    }
+    return { conflicts, redundancies, synergies, conditionals };
+}
+/**
+ * Get suggestions based on synergy rules.
+ * If user has MCP A and rule says A+B is a synergy,
+ * suggest B if user doesn't have it.
+ *
+ * @param mcps - Array of installed MCP IDs
+ * @param allRules - All compatibility rules
+ * @returns Array of suggestions
+ */
+export function getSuggestions(mcps, allRules) {
+    const suggestions = [];
+    const canonicalMcps = new Set(mcps.map(canonicalizeMcpId));
+    const suggestedSet = new Set();
+    // Find synergy rules where user has one but not the other
+    for (const rule of allRules) {
+        if (rule.status !== 'synergy')
+            continue;
+        const hasA = canonicalMcps.has(rule.mcpA);
+        const hasB = canonicalMcps.has(rule.mcpB);
+        // If user has A but not B
+        if (hasA && !hasB && !suggestedSet.has(rule.mcpB)) {
+            suggestions.push({
+                mcp: rule.mcpB,
+                reason: rule.reason,
+                basedOn: rule.mcpA,
+            });
+            suggestedSet.add(rule.mcpB);
+        }
+        // If user has B but not A
+        if (hasB && !hasA && !suggestedSet.has(rule.mcpA)) {
+            suggestions.push({
+                mcp: rule.mcpA,
+                reason: rule.reason,
+                basedOn: rule.mcpB,
+            });
+            suggestedSet.add(rule.mcpA);
+        }
+        // Check suggestWhenMissing field
+        if (rule.suggestWhenMissing && (hasA || hasB)) {
+            for (const suggested of rule.suggestWhenMissing) {
+                const canonSuggested = canonicalizeMcpId(suggested);
+                if (!canonicalMcps.has(canonSuggested) && !suggestedSet.has(canonSuggested)) {
+                    suggestions.push({
+                        mcp: canonSuggested,
+                        reason: `Pairs well with ${hasA ? rule.mcpA : rule.mcpB}`,
+                        basedOn: hasA ? rule.mcpA : rule.mcpB,
+                    });
+                    suggestedSet.add(canonSuggested);
+                }
+            }
+        }
+    }
+    return suggestions;
+}
+//# sourceMappingURL=utils.js.map

package/dist/lib/mcp-compatibility/utils.js.map

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

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoDpE;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAmbxC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiFpE;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAsjBxC"}

package/dist/server.js

@@ -9,6 +9,11 @@ import { getBlueprintToolDefinition, executeGetBlueprint, GetBlueprintInputSchem
 import { recommendStackDemoToolDefinition, executeRecommendStackDemo, RecommendStackDemoInputSchema } from './tools/recommend-demo.js';
 import { setupApiKeyToolDefinition, executeSetupApiKey, SetupApiKeyInputSchema, listApiKeysToolDefinition, executeListApiKeys, revokeApiKeyToolDefinition, executeRevokeApiKey, RevokeApiKeyInputSchema } from './tools/api-keys.js';
 import { createAuditToolDefinition, executeCreateAudit, CreateAuditInputSchema, getAuditToolDefinition, executeGetAudit, GetAuditInputSchema, listAuditsToolDefinition, executeListAudits, ListAuditsInputSchema, compareAuditsToolDefinition, executeCompareAudits, CompareAuditsInputSchema, getAuditQuotaToolDefinition, executeGetAuditQuota, getMigrationRecommendationToolDefinition, executeGetMigrationRecommendation, GetMigrationRecommendationInputSchema } from './tools/audit.js';
+import { generateMCPKitTool, generateMCPKit, GenerateMCPKitInputSchema, analyzeRepoMcpsTool, analyzeRepo, AnalyzeRepoMCPsInputSchema, PRIORITIES, PROJECT_TYPES, SCALES } from './tools/project-kit/index.js';
+import { prepareMCPInstallationTool, prepareMCPInstallation } from './tools/project-kit/prepare-installation.js';
+import { executeMCPInstallationTool, executeMCPInstallation } from './tools/project-kit/execute-installation.js';
+import { PrepareMCPInstallationInputSchema, ExecuteMCPInstallationInputSchema } from './tools/project-kit/installation-types.js';
+import { checkCompatibilityToolDefinition, executeCheckCompatibility, CheckCompatibilityInputSchema } from './tools/check-compatibility.js';
 import { info, debug } from './utils/logger.js';
 /**
  * Create and configure the MCP server.
@@ -356,7 +361,297 @@ export function createServer() {
             isError
         };
     });
-    info('Registered 16 tools: list_technologies, analyze_tech, compare_techs, recommend_stack_demo, recommend_stack, get_blueprint, create_blueprint, setup_api_key, list_api_keys, revoke_api_key, create_audit, get_audit, list_audits, compare_audits, get_audit_quota, get_migration_recommendation');
+    // ========================================================================
+    // PROJECT-KIT TOOLS (MCPFinder)
+    // ========================================================================
+    // Register generate_mcp_kit tool (local, no API key required)
+    server.registerTool(generateMCPKitTool.name, {
+        title: 'Generate MCP Kit',
+        description: generateMCPKitTool.description,
+        inputSchema: {
+            projectDescription: z.string().min(50).max(5000).describe('Describe your project (50-5000 chars)'),
+            priorities: z.array(z.enum(PRIORITIES)).max(3).optional().describe('Top priorities (max 3)'),
+            constraints: z.array(z.string()).optional().describe('Tech constraints (e.g., must-use-postgresql)'),
+            projectType: z.enum(PROJECT_TYPES).optional().describe('Project type (if known)'),
+            scale: z.enum(SCALES).optional().describe('Project scale (if known)')
+        }
+    }, async (args) => {
+        debug('generate_mcp_kit called', args);
+        const input = GenerateMCPKitInputSchema.parse(args);
+        const result = generateMCPKit(input);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }]
+        };
+    });
+    // Register analyze_repo_mcps tool (local, no API key required)
+    server.registerTool(analyzeRepoMcpsTool.name, {
+        title: 'Analyze Repository MCPs',
+        description: analyzeRepoMcpsTool.description,
+        inputSchema: {
+            includeInstalled: z.boolean().optional().describe('Include already installed MCPs (default: false)'),
+            mcpConfigPath: z.string().optional().describe('Override path to MCP configuration file'),
+            workspaceRoot: z.string().optional().describe('Override workspace root directory (default: current directory)')
+        }
+    }, async (args) => {
+        debug('analyze_repo_mcps called', args);
+        const input = AnalyzeRepoMCPsInputSchema.parse(args);
+        const result = await analyzeRepo(input);
+        // Format as markdown for better readability
+        return {
+            content: [{ type: 'text', text: formatAnalysisResult(result) }]
+        };
+    });
+    // Register prepare_mcp_installation tool (local, no API key required)
+    server.registerTool(prepareMCPInstallationTool.name, {
+        title: 'Prepare MCP Installation',
+        description: prepareMCPInstallationTool.description,
+        inputSchema: {
+            workspaceRoot: z.string().optional().describe('Workspace root directory (default: current directory)'),
+            mcpConfigPath: z.string().optional().describe('Override path to existing MCP configuration file'),
+            includeInstalled: z.boolean().optional().describe('Include already installed MCPs in the preparation (default: false)'),
+            envMcpPath: z.string().optional().describe('Path where .env-mcp will be created (default: .env-mcp in workspaceRoot)')
+        }
+    }, async (args) => {
+        debug('prepare_mcp_installation called', args);
+        const input = PrepareMCPInstallationInputSchema.parse(args);
+        const result = await prepareMCPInstallation(input);
+        return {
+            content: [{ type: 'text', text: result.message + '\n\n' + formatPreparationSummary(result) }]
+        };
+    });
+    // Register execute_mcp_installation tool (local, no API key required)
+    server.registerTool(executeMCPInstallationTool.name, {
+        title: 'Execute MCP Installation',
+        description: executeMCPInstallationTool.description,
+        inputSchema: {
+            envMcpPath: z.string().optional().describe('Path to .env-mcp file (default: .env-mcp in current directory)'),
+            targetClient: z
+                .enum(['claude-code', 'claude-desktop', 'cursor', 'vscode', 'windsurf'])
+                .optional()
+                .describe('Target IDE/client for installation (default: claude-code)'),
+            dryRun: z.boolean().optional().describe('Only generate commands without marking ready to execute (default: false)')
+        }
+    }, async (args) => {
+        debug('execute_mcp_installation called', args);
+        const input = ExecuteMCPInstallationInputSchema.parse(args);
+        const result = await executeMCPInstallation(input);
+        return {
+            content: [{ type: 'text', text: formatExecutionResult(result) }]
+        };
+    });
+    // ========================================================================
+    // COMPATIBILITY TOOL (MCP Conflict Detection)
+    // ========================================================================
+    // Register check_mcp_compatibility tool (local, no API key required)
+    server.registerTool(checkCompatibilityToolDefinition.name, {
+        title: 'Check MCP Compatibility',
+        description: checkCompatibilityToolDefinition.description,
+        inputSchema: {
+            mcps: z
+                .array(z.string().min(1))
+                .min(1)
+                .max(20)
+                .describe('Array of MCP server IDs to check compatibility between')
+        }
+    }, async (args) => {
+        debug('check_mcp_compatibility called', args);
+        const input = CheckCompatibilityInputSchema.parse(args);
+        const { text, data, isError } = executeCheckCompatibility(input);
+        return {
+            content: [
+                { type: 'text', text },
+                { type: 'text', text: `\n---\n\n**Structured Data:**\n\`\`\`json\n${JSON.stringify(data, null, 2)}\n\`\`\`` }
+            ],
+            isError
+        };
+    });
+    info('Registered 21 tools: list_technologies, analyze_tech, compare_techs, recommend_stack_demo, recommend_stack, get_blueprint, create_blueprint, setup_api_key, list_api_keys, revoke_api_key, create_audit, get_audit, list_audits, compare_audits, get_audit_quota, get_migration_recommendation, generate_mcp_kit, analyze_repo_mcps, prepare_mcp_installation, execute_mcp_installation, check_mcp_compatibility');
     return server;
 }
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+/**
+ * Format analyze_repo_mcps result as readable markdown.
+ */
+function formatAnalysisResult(result) {
+    const lines = [];
+    lines.push('# Repository Analysis\n');
+    // Detected Stack
+    lines.push('## Detected Technologies\n');
+    const stackItems = [
+        result.detectedStack.frontend &&
+            `- **Frontend**: ${result.detectedStack.frontend.name}${result.detectedStack.frontend.version ? ` (${result.detectedStack.frontend.version})` : ''}`,
+        result.detectedStack.backend &&
+            `- **Backend**: ${result.detectedStack.backend.name}${result.detectedStack.backend.version ? ` (${result.detectedStack.backend.version})` : ''}`,
+        result.detectedStack.database &&
+            `- **Database**: ${result.detectedStack.database.name}${result.detectedStack.database.version ? ` (${result.detectedStack.database.version})` : ''}`,
+        result.detectedStack.orm &&
+            `- **ORM**: ${result.detectedStack.orm.name}${result.detectedStack.orm.version ? ` (${result.detectedStack.orm.version})` : ''}`,
+        result.detectedStack.auth &&
+            `- **Auth**: ${result.detectedStack.auth.name}${result.detectedStack.auth.version ? ` (${result.detectedStack.auth.version})` : ''}`,
+        result.detectedStack.hosting &&
+            `- **Hosting**: ${result.detectedStack.hosting.name}${result.detectedStack.hosting.version ? ` (${result.detectedStack.hosting.version})` : ''}`,
+        result.detectedStack.payments &&
+            `- **Payments**: ${result.detectedStack.payments.name}${result.detectedStack.payments.version ? ` (${result.detectedStack.payments.version})` : ''}`
+    ].filter((item) => Boolean(item));
+    if (stackItems.length > 0) {
+        lines.push(...stackItems);
+    }
+    else {
+        lines.push('_No technologies detected from project files._');
+    }
+    if (result.detectedStack.services.length > 0) {
+        lines.push('\n**Services**:');
+        for (const service of result.detectedStack.services) {
+            lines.push(`- ${service.name}`);
+        }
+    }
+    lines.push('');
+    // Files Analyzed
+    lines.push('## Files Analyzed\n');
+    if (result.metadata.filesAnalyzed.length > 0) {
+        lines.push(result.metadata.filesAnalyzed.map((f) => `- \`${f}\``).join('\n'));
+    }
+    else {
+        lines.push('_No recognized configuration files found._');
+    }
+    lines.push('');
+    // Installed MCPs
+    if (result.installedMcps.length > 0) {
+        lines.push('## Already Installed MCPs\n');
+        lines.push(result.installedMcps.map((m) => `- ${m}`).join('\n'));
+        lines.push('');
+    }
+    // Recommended MCPs
+    lines.push('## Recommended MCPs\n');
+    if (result.recommendedMcps.length === 0) {
+        lines.push('_No additional MCPs recommended. You have everything you need!_');
+    }
+    else {
+        // Group by priority
+        const highPriority = result.recommendedMcps.filter((m) => m.priority === 'high');
+        const mediumPriority = result.recommendedMcps.filter((m) => m.priority === 'medium');
+        const lowPriority = result.recommendedMcps.filter((m) => m.priority === 'low');
+        if (highPriority.length > 0) {
+            lines.push('### High Priority\n');
+            for (const mcp of highPriority) {
+                lines.push(`**${mcp.name}** (\`${mcp.slug}\`)`);
+                lines.push(`- ${mcp.description}`);
+                lines.push(`- _Matched: ${mcp.matchedTech}_`);
+                lines.push('');
+            }
+        }
+        if (mediumPriority.length > 0) {
+            lines.push('### Medium Priority\n');
+            for (const mcp of mediumPriority) {
+                lines.push(`**${mcp.name}** (\`${mcp.slug}\`)`);
+                lines.push(`- ${mcp.description}`);
+                lines.push(`- _Matched: ${mcp.matchedTech}_`);
+                lines.push('');
+            }
+        }
+        if (lowPriority.length > 0) {
+            lines.push('### Low Priority\n');
+            for (const mcp of lowPriority) {
+                lines.push(`**${mcp.name}** (\`${mcp.slug}\`)`);
+                lines.push(`- ${mcp.description}`);
+                lines.push(`- _Matched: ${mcp.matchedTech}_`);
+                lines.push('');
+            }
+        }
+    }
+    // Quick Install
+    if (result.recommendedMcps.length > 0) {
+        lines.push('## Quick Install\n');
+        lines.push('Add to your Claude Desktop config (`claude_desktop_config.json`):\n');
+        lines.push('```json');
+        lines.push(JSON.stringify(result.installConfig.claudeDesktop, null, 2));
+        lines.push('```\n');
+    }
+    // Metadata
+    lines.push(`---\n_Analysis completed: ${result.metadata.analysisDate}_`);
+    return lines.join('\n');
+}
+/**
+ * Format prepare_mcp_installation result summary.
+ */
+function formatPreparationSummary(result) {
+    const lines = [];
+    // MCPs to install grouped by priority
+    if (result.mcpsToInstall.length > 0) {
+        lines.push('## MCPs to Install\n');
+        const highPriority = result.mcpsToInstall.filter((m) => m.priority === 'high');
+        const mediumPriority = result.mcpsToInstall.filter((m) => m.priority === 'medium');
+        const lowPriority = result.mcpsToInstall.filter((m) => m.priority === 'low');
+        if (highPriority.length > 0) {
+            lines.push('### 🔴 High Priority');
+            for (const mcp of highPriority) {
+                const requiredVars = mcp.envVars.filter((v) => v.requirement === 'required').length;
+                lines.push(`- **${mcp.name}** (${requiredVars} required vars)`);
+            }
+            lines.push('');
+        }
+        if (mediumPriority.length > 0) {
+            lines.push('### 🟡 Medium Priority');
+            for (const mcp of mediumPriority) {
+                const requiredVars = mcp.envVars.filter((v) => v.requirement === 'required').length;
+                lines.push(`- **${mcp.name}** (${requiredVars} required vars)`);
+            }
+            lines.push('');
+        }
+        if (lowPriority.length > 0) {
+            lines.push('### 🟢 Low Priority');
+            for (const mcp of lowPriority) {
+                const requiredVars = mcp.envVars.filter((v) => v.requirement === 'required').length;
+                lines.push(`- **${mcp.name}** (${requiredVars} required vars)`);
+            }
+            lines.push('');
+        }
+    }
+    // Already installed
+    if (result.installedMcps.length > 0) {
+        lines.push('## Already Installed');
+        for (const mcp of result.installedMcps) {
+            lines.push(`- ✅ ${mcp}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Format execute_mcp_installation result.
+ */
+function formatExecutionResult(result) {
+    const lines = [];
+    lines.push(result.message);
+    lines.push('');
+    // Show aggregate command for Claude Code
+    if (result.aggregateCommand) {
+        lines.push('---\n');
+        lines.push('## Claude Code Installation\n');
+        lines.push('Run this command to install all ready MCPs:\n');
+        lines.push('```bash');
+        lines.push(result.aggregateCommand);
+        lines.push('```\n');
+    }
+    // Show JSON config for other clients
+    if (result.aggregateConfig && !result.aggregateCommand) {
+        lines.push('---\n');
+        lines.push('## JSON Configuration\n');
+        lines.push('Add this to your MCP configuration file:\n');
+        lines.push('```json');
+        lines.push(JSON.stringify(result.aggregateConfig, null, 2));
+        lines.push('```\n');
+    }
+    // Post-install instructions
+    if (result.postInstallInstructions.length > 0) {
+        lines.push('---\n');
+        lines.push('## Post-Installation\n');
+        for (const instruction of result.postInstallInstructions) {
+            lines.push(instruction);
+        }
+    }
+    return lines.join('\n');
+}
 //# sourceMappingURL=server.js.map