@stacksfinder/mcp-server 1.1.0 → 1.2.1

package/dist/tools/project-kit/prepare-installation.js

@@ -0,0 +1,382 @@
+/**
+ * prepare_mcp_installation Tool
+ *
+ * Analyzes a repository, detects needed MCPs, and generates a .env-mcp
+ * template file for the user to fill in with their API keys.
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { z } from 'zod';
+import { PrepareMCPInstallationInputSchema, getMCPRegistryEntry } from './installation-types.js';
+import { analyzeRepo } from './analyze-repo.js';
+import { info, error, debug } from '../../utils/logger.js';
+// ============================================================================
+// ENV-MCP FILE GENERATION
+// ============================================================================
+/**
+ * Generate the content for .env-mcp file.
+ */
+function generateEnvMcpContent(mcpsToInstall) {
+    const lines = [];
+    const timestamp = new Date().toISOString();
+    // Header
+    lines.push('# ============================================================================');
+    lines.push('# MCP INSTALLATION CONFIGURATION');
+    lines.push(`# Generated: ${timestamp}`);
+    lines.push('# ============================================================================');
+    lines.push('#');
+    lines.push('# This file contains environment variables needed for MCP server installation.');
+    lines.push('# Fill in the values for the MCPs you want to install.');
+    lines.push('#');
+    lines.push('# Requirements:');
+    lines.push('#   [REQUIRED]    - Must be filled for the MCP to work');
+    lines.push('#   [OPTIONAL]    - Can be left empty, MCP will use defaults');
+    lines.push('#   [CONDITIONAL] - Required only if specific feature is used');
+    lines.push('#');
+    lines.push('# After filling in the values, run the execute_mcp_installation tool');
+    lines.push('# to install the MCPs.');
+    lines.push('# ============================================================================');
+    lines.push('');
+    // Installation Control Section
+    lines.push('# ============================================================================');
+    lines.push('# INSTALLATION CONTROL');
+    lines.push('# ============================================================================');
+    lines.push('# Set to "true" for MCPs you want to install, "false" to skip.');
+    lines.push('');
+    for (const mcp of mcpsToInstall) {
+        const varName = `INSTALL_${mcp.slug.toUpperCase().replace(/-/g, '_')}`;
+        lines.push(`# ${mcp.name} - ${mcp.description}`);
+        lines.push(`# Priority: ${mcp.priority.toUpperCase()} | Matched: ${mcp.matchedTech}`);
+        lines.push(`${varName}=true`);
+        lines.push('');
+    }
+    // Group MCPs by category
+    const mcpsByCategory = new Map();
+    for (const mcp of mcpsToInstall) {
+        const category = mcp.category;
+        if (!mcpsByCategory.has(category)) {
+            mcpsByCategory.set(category, []);
+        }
+        mcpsByCategory.get(category).push(mcp);
+    }
+    // Generate env vars by category
+    for (const [category, mcps] of mcpsByCategory) {
+        lines.push('# ============================================================================');
+        lines.push(`# ${category.toUpperCase().replace(/-/g, ' ')}`);
+        lines.push('# ============================================================================');
+        lines.push('');
+        for (const mcp of mcps) {
+            lines.push(`# --- ${mcp.name} ---`);
+            if (mcp.docsUrl) {
+                lines.push(`# Docs: ${mcp.docsUrl}`);
+            }
+            if (mcp.githubUrl) {
+                lines.push(`# GitHub: ${mcp.githubUrl}`);
+            }
+            lines.push('');
+            if (mcp.envVars.length === 0) {
+                lines.push('# No environment variables required for this MCP.');
+                lines.push('');
+            }
+            else {
+                for (const envVar of mcp.envVars) {
+                    const requirementTag = `[${envVar.requirement.toUpperCase()}]`;
+                    lines.push(`# ${requirementTag} ${envVar.description}`);
+                    if (envVar.example) {
+                        lines.push(`# Example: ${envVar.example}`);
+                    }
+                    if (envVar.condition) {
+                        lines.push(`# Condition: ${envVar.condition}`);
+                    }
+                    lines.push(`${envVar.name}=`);
+                    lines.push('');
+                }
+            }
+        }
+    }
+    // Footer
+    lines.push('# ============================================================================');
+    lines.push('# END OF CONFIGURATION');
+    lines.push('# ============================================================================');
+    lines.push('# Run: execute_mcp_installation to install the MCPs with these settings.');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Convert MCPRecommendation to MCPInstallInfo with full details.
+ */
+function enrichMCPRecommendation(slug, matchedTech, priority, category) {
+    const registryEntry = getMCPRegistryEntry(slug);
+    if (!registryEntry) {
+        // Fallback for MCPs not in registry
+        debug(`MCP ${slug} not found in registry, using minimal info`);
+        return {
+            slug,
+            name: formatMCPName(slug),
+            description: `MCP server for ${matchedTech}`,
+            priority: priority,
+            matchedTech,
+            category,
+            installCommand: `npx -y ${slug}`,
+            envVars: []
+        };
+    }
+    return {
+        slug: registryEntry.slug,
+        name: registryEntry.name,
+        description: registryEntry.description,
+        priority: priority,
+        matchedTech,
+        category: registryEntry.category,
+        installCommand: `npx -y ${registryEntry.npmPackage}`,
+        envVars: registryEntry.envVars,
+        githubUrl: registryEntry.githubUrl,
+        docsUrl: registryEntry.docsUrl
+    };
+}
+/**
+ * Format MCP slug into human-readable name.
+ */
+function formatMCPName(slug) {
+    return slug
+        .replace(/-mcp$/, '')
+        .split('-')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ')
+        .concat(' MCP');
+}
+// ============================================================================
+// TOOL IMPLEMENTATION
+// ============================================================================
+/**
+ * Prepare MCP installation by analyzing repo and generating .env-mcp.
+ */
+export async function prepareMCPInstallation(input) {
+    const workspaceRoot = input.workspaceRoot || process.cwd();
+    const envMcpPath = input.envMcpPath || path.join(workspaceRoot, '.env-mcp');
+    info(`Preparing MCP installation for workspace: ${workspaceRoot}`);
+    // Step 1: Analyze the repository
+    const analysisResult = await analyzeRepo({
+        workspaceRoot,
+        mcpConfigPath: input.mcpConfigPath,
+        includeInstalled: input.includeInstalled
+    });
+    // Step 2: Enrich recommendations with full install info
+    const mcpsToInstall = [];
+    for (const rec of analysisResult.recommendedMcps) {
+        const installInfo = enrichMCPRecommendation(rec.slug, rec.matchedTech, rec.priority, rec.category);
+        if (installInfo) {
+            mcpsToInstall.push(installInfo);
+        }
+    }
+    info(`Found ${mcpsToInstall.length} MCPs to install`);
+    // Step 3: Generate .env-mcp content
+    const envMcpContent = generateEnvMcpContent(mcpsToInstall);
+    // Step 4: Write .env-mcp file
+    try {
+        await fs.writeFile(envMcpPath, envMcpContent, 'utf-8');
+        info(`Generated .env-mcp at: ${envMcpPath}`);
+    }
+    catch (err) {
+        error(`Failed to write .env-mcp: ${err}`);
+        throw new Error(`Failed to write .env-mcp file: ${err}`);
+    }
+    // Step 5: Generate summary message
+    const requiredVarsCount = mcpsToInstall.reduce((count, mcp) => count + mcp.envVars.filter((v) => v.requirement === 'required').length, 0);
+    const message = [
+        `✅ Generated .env-mcp with ${mcpsToInstall.length} MCP(s) to install.`,
+        '',
+        '📋 Next steps:',
+        `1. Open ${envMcpPath}`,
+        `2. Fill in the ${requiredVarsCount} required environment variable(s)`,
+        '3. Set INSTALL_xxx=false for any MCPs you want to skip',
+        '4. Run execute_mcp_installation to install the MCPs',
+        '',
+        `📁 File location: ${envMcpPath}`
+    ].join('\n');
+    return {
+        envMcpPath,
+        mcpsToInstall,
+        installedMcps: analysisResult.installedMcps,
+        message,
+        envMcpContent
+    };
+}
+// ============================================================================
+// TOOL HANDLER
+// ============================================================================
+/**
+ * Tool definition for MCP server registration.
+ */
+export const prepareMCPInstallationTool = {
+    name: 'prepare_mcp_installation',
+    description: `Analyze your repository and generate a .env-mcp configuration file for MCP server installation.
+
+This tool:
+1. Detects your tech stack from project files (package.json, .env, etc.)
+2. Identifies which MCP servers would benefit your project
+3. Finds already installed MCPs to avoid duplicates
+4. Generates a .env-mcp template file with all required environment variables
+
+The generated .env-mcp file contains:
+- INSTALL_xxx flags to control which MCPs to install
+- Required and optional environment variables for each MCP
+- Documentation links and examples
+
+After running this tool:
+1. Open the generated .env-mcp file
+2. Fill in the API keys and configuration values
+3. Set INSTALL_xxx=false for MCPs you don't want
+4. Run execute_mcp_installation to complete the setup
+
+Example use cases:
+- "Prepare MCP installation for my project"
+- "Generate .env-mcp for my tech stack"
+- "What MCPs do I need and what credentials do they require?"`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            workspaceRoot: {
+                type: 'string',
+                description: 'Workspace root directory (default: current directory)'
+            },
+            mcpConfigPath: {
+                type: 'string',
+                description: 'Override path to existing MCP configuration file'
+            },
+            includeInstalled: {
+                type: 'boolean',
+                description: 'Include already installed MCPs in the preparation (default: false)',
+                default: false
+            },
+            envMcpPath: {
+                type: 'string',
+                description: 'Path where .env-mcp will be created (default: .env-mcp in workspaceRoot)'
+            }
+        }
+    },
+    handler: async (params) => {
+        try {
+            const input = PrepareMCPInstallationInputSchema.parse(params);
+            const result = await prepareMCPInstallation(input);
+            // Format output for display
+            const output = formatPreparationOutput(result);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: output
+                    }
+                ]
+            };
+        }
+        catch (err) {
+            if (err instanceof z.ZodError) {
+                error('Invalid input:', err.errors);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Invalid input: ${err.errors.map((e) => e.message).join(', ')}`
+                        }
+                    ],
+                    isError: true
+                };
+            }
+            error('prepare_mcp_installation error:', err);
+            throw err;
+        }
+    }
+};
+// ============================================================================
+// OUTPUT FORMATTING
+// ============================================================================
+/**
+ * Format preparation output for display.
+ */
+function formatPreparationOutput(result) {
+    const lines = [];
+    lines.push('# MCP Installation Preparation\n');
+    // Summary
+    lines.push('## Summary\n');
+    lines.push(`- **MCPs to install**: ${result.mcpsToInstall.length}`);
+    lines.push(`- **Already installed**: ${result.installedMcps.length}`);
+    lines.push(`- **Config file**: \`${result.envMcpPath}\``);
+    lines.push('');
+    // Already installed
+    if (result.installedMcps.length > 0) {
+        lines.push('## Already Installed MCPs\n');
+        for (const mcp of result.installedMcps) {
+            lines.push(`- ✅ ${mcp}`);
+        }
+        lines.push('');
+    }
+    // MCPs to install
+    if (result.mcpsToInstall.length > 0) {
+        lines.push('## MCPs to Install\n');
+        // Group by priority
+        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\n');
+            for (const mcp of highPriority) {
+                const requiredVars = mcp.envVars.filter((v) => v.requirement === 'required');
+                lines.push(`**${mcp.name}** (\`${mcp.slug}\`)`);
+                lines.push(`- ${mcp.description}`);
+                lines.push(`- Matched: ${mcp.matchedTech}`);
+                if (requiredVars.length > 0) {
+                    lines.push(`- Required vars: ${requiredVars.map((v) => v.name).join(', ')}`);
+                }
+                else {
+                    lines.push('- No credentials required');
+                }
+                lines.push('');
+            }
+        }
+        if (mediumPriority.length > 0) {
+            lines.push('### 🟡 Medium Priority\n');
+            for (const mcp of mediumPriority) {
+                const requiredVars = mcp.envVars.filter((v) => v.requirement === 'required');
+                lines.push(`**${mcp.name}** (\`${mcp.slug}\`)`);
+                lines.push(`- ${mcp.description}`);
+                lines.push(`- Matched: ${mcp.matchedTech}`);
+                if (requiredVars.length > 0) {
+                    lines.push(`- Required vars: ${requiredVars.map((v) => v.name).join(', ')}`);
+                }
+                else {
+                    lines.push('- No credentials required');
+                }
+                lines.push('');
+            }
+        }
+        if (lowPriority.length > 0) {
+            lines.push('### 🟢 Low Priority\n');
+            for (const mcp of lowPriority) {
+                const requiredVars = mcp.envVars.filter((v) => v.requirement === 'required');
+                lines.push(`**${mcp.name}** (\`${mcp.slug}\`)`);
+                lines.push(`- ${mcp.description}`);
+                lines.push(`- Matched: ${mcp.matchedTech}`);
+                if (requiredVars.length > 0) {
+                    lines.push(`- Required vars: ${requiredVars.map((v) => v.name).join(', ')}`);
+                }
+                else {
+                    lines.push('- No credentials required');
+                }
+                lines.push('');
+            }
+        }
+    }
+    // Next steps
+    lines.push('## Next Steps\n');
+    lines.push('1. 📝 Open the generated `.env-mcp` file');
+    lines.push('2. 🔑 Fill in the required API keys and credentials');
+    lines.push('3. ⚙️ Set `INSTALL_xxx=false` for MCPs you want to skip');
+    lines.push('4. 🚀 Run `execute_mcp_installation` to install the MCPs');
+    lines.push('');
+    // File location
+    lines.push('---\n');
+    lines.push(`📁 Configuration file: \`${result.envMcpPath}\``);
+    return lines.join('\n');
+}
+//# sourceMappingURL=prepare-installation.js.map

package/dist/tools/project-kit/prepare-installation.js.map

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

package/dist/tools/project-kit/types.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Shared types for MCPFinder project-kit tools.
+ *
+ * These types define the input/output schemas for:
+ * - generate_mcp_kit: Project description -> stack + MCPs
+ * - analyze_repo_mcps: Repo files -> detected stack -> MCPs
+ */
+import { z } from 'zod';
+export declare const PRIORITIES: readonly ["time-to-market", "scalability", "developer-experience", "cost-efficiency", "performance", "security", "maintainability"];
+export type Priority = (typeof PRIORITIES)[number];
+export declare const PROJECT_TYPES: readonly ["web-app", "mobile-app", "api", "saas", "e-commerce", "marketplace", "cli", "library"];
+export type ProjectType = (typeof PROJECT_TYPES)[number];
+export declare const SCALES: readonly ["mvp", "startup", "growth", "enterprise"];
+export type Scale = (typeof SCALES)[number];
+export declare const TECH_TYPES: readonly ["frontend", "backend", "database", "orm", "service", "auth", "hosting", "payments"];
+export type TechType = (typeof TECH_TYPES)[number];
+export declare const MCP_PRIORITIES: readonly ["high", "medium", "low"];
+export type MCPPriority = (typeof MCP_PRIORITIES)[number];
+/**
+ * A detected technology from project files.
+ */
+export interface Detection {
+    type: TechType;
+    name: string;
+    version?: string;
+    confidence: number;
+    source: string;
+}
+/**
+ * Aggregated detected stack from all sources.
+ */
+export interface DetectedStack {
+    frontend?: DetectedTech;
+    backend?: DetectedTech;
+    database?: DetectedTech;
+    orm?: DetectedTech;
+    auth?: DetectedTech;
+    hosting?: DetectedTech;
+    payments?: DetectedTech;
+    services: DetectedTech[];
+}
+export interface DetectedTech {
+    name: string;
+    version?: string;
+    confidence: number;
+    source: string;
+}
+/**
+ * A recommended MCP server.
+ */
+export interface MCPRecommendation {
+    slug: string;
+    name: string;
+    description: string;
+    priority: MCPPriority;
+    reason: string;
+    matchedTech: string;
+    installCommand?: string;
+    category: string;
+    githubUrl?: string;
+}
+/**
+ * Install configuration for multiple clients.
+ */
+export interface MCPInstallConfigs {
+    cursor: Record<string, unknown>;
+    claudeDesktop: Record<string, unknown>;
+    windsurf: Record<string, unknown>;
+}
+export declare const GenerateMCPKitInputSchema: z.ZodObject<{
+    projectDescription: z.ZodString;
+    priorities: z.ZodOptional<z.ZodArray<z.ZodEnum<["time-to-market", "scalability", "developer-experience", "cost-efficiency", "performance", "security", "maintainability"]>, "many">>;
+    constraints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    projectType: z.ZodOptional<z.ZodEnum<["web-app", "mobile-app", "api", "saas", "e-commerce", "marketplace", "cli", "library"]>>;
+    scale: z.ZodOptional<z.ZodEnum<["mvp", "startup", "growth", "enterprise"]>>;
+}, "strip", z.ZodTypeAny, {
+    projectDescription: string;
+    projectType?: "web-app" | "mobile-app" | "api" | "cli" | "library" | "e-commerce" | "saas" | "marketplace" | undefined;
+    scale?: "mvp" | "enterprise" | "startup" | "growth" | undefined;
+    priorities?: ("time-to-market" | "scalability" | "developer-experience" | "cost-efficiency" | "performance" | "security" | "maintainability")[] | undefined;
+    constraints?: string[] | undefined;
+}, {
+    projectDescription: string;
+    projectType?: "web-app" | "mobile-app" | "api" | "cli" | "library" | "e-commerce" | "saas" | "marketplace" | undefined;
+    scale?: "mvp" | "enterprise" | "startup" | "growth" | undefined;
+    priorities?: ("time-to-market" | "scalability" | "developer-experience" | "cost-efficiency" | "performance" | "security" | "maintainability")[] | undefined;
+    constraints?: string[] | undefined;
+}>;
+export type GenerateMCPKitInput = z.infer<typeof GenerateMCPKitInputSchema>;
+export interface TechRecommendation {
+    id: string;
+    name: string;
+    score: number;
+    grade: string;
+    reason: string;
+}
+export interface GenerateMCPKitOutput {
+    stack: {
+        frontend?: TechRecommendation;
+        backend?: TechRecommendation;
+        database?: TechRecommendation;
+        auth?: TechRecommendation;
+        hosting?: TechRecommendation;
+        payments?: TechRecommendation;
+    };
+    mcps: MCPRecommendation[];
+    rationale: string;
+    detectedConstraints: string[];
+    metadata: {
+        scoringVersion: string;
+        generatedAt: string;
+    };
+}
+export declare const AnalyzeRepoMCPsInputSchema: z.ZodObject<{
+    includeInstalled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    mcpConfigPath: z.ZodOptional<z.ZodString>;
+    workspaceRoot: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    includeInstalled: boolean;
+    mcpConfigPath?: string | undefined;
+    workspaceRoot?: string | undefined;
+}, {
+    includeInstalled?: boolean | undefined;
+    mcpConfigPath?: string | undefined;
+    workspaceRoot?: string | undefined;
+}>;
+export type AnalyzeRepoMCPsInput = z.infer<typeof AnalyzeRepoMCPsInputSchema>;
+/**
+ * Compatibility check results for installed MCPs.
+ */
+export interface MCPCompatibilityResult {
+    score: number;
+    grade: 'A' | 'B' | 'C' | 'D';
+    conflicts: Array<{
+        mcpA: string;
+        mcpB: string;
+        reason: string;
+        severity: 'critical' | 'warning' | 'info';
+    }>;
+    redundancies: Array<{
+        mcpA: string;
+        mcpB: string;
+        reason: string;
+        severity: 'critical' | 'warning' | 'info';
+    }>;
+    synergies: Array<{
+        mcpA: string;
+        mcpB: string;
+        reason: string;
+    }>;
+    suggestions: Array<{
+        mcp: string;
+        reason: string;
+        basedOn: string;
+    }>;
+}
+/**
+ * MCPs excluded from recommendations with reasons.
+ */
+export interface ExcludedRecommendation {
+    mcp: string;
+    reason: string;
+    conflictsWith: string;
+}
+export interface AnalyzeRepoMCPsOutput {
+    detectedStack: DetectedStack;
+    installedMcps: string[];
+    recommendedMcps: MCPRecommendation[];
+    excludedRecommendations: ExcludedRecommendation[];
+    compatibility: {
+        installed: MCPCompatibilityResult;
+        recommendationConflicts: Array<{
+            recommended: string;
+            conflictsWith: string;
+            reason: string;
+        }>;
+    };
+    installConfig: MCPInstallConfigs;
+    metadata: {
+        filesAnalyzed: string[];
+        analysisDate: string;
+    };
+}
+export interface DetectionRule {
+    file: string;
+    parser: (content: string) => Detection[];
+    priority: number;
+}
+/**
+ * MCPs that are always recommended regardless of detected stack.
+ */
+export declare const UNIVERSAL_MCPS: Array<{
+    slug: string;
+    name: string;
+    description: string;
+    priority: MCPPriority;
+    reason: string;
+    category: string;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/project-kit/types.d.ts.map

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